PTR Tracker API Documentation

Base URL: https://api.solutionhub.io

All endpoints require an Authorization: Bearer <API_TOKEN> header. Responses are JSON. Use the Senate endpoints to enumerate members, fetch individual disclosures, and compute both realized and virtual (mark-to-market) performance.

GET /v1/senate/members

List all Senate members with trading metadata.

Description

Returns all tracked senators and ex-members with aggregate trading stats: total trade count, trade score, and date of last disclosed trade.

Query parameters

None.

Response

An array of member objects:

Field	Type	Description
id	integer	Internal identifier for the senator.
name	string	Full name.
chamber	string	Always `Senate` for this endpoint.
party	string	Party affiliation.
trade_count	integer	Total number of parsed transactions.
trade_score	number	Composite score derived from realized/virtual ROI and timing.
last_trade_date	date (YYYY-MM-DD)	Most recent transaction date for this member.

                  cURL
                  Auth Bearer token
                
curl "https://api.solutionhub.io/v1/senate/members" \
  -H "Authorization: Bearer <API_TOKEN>"

                  Sample response
                

[
  {
    "id": 1,
    "name": "Markwayne Mullin",
    "chamber": "Senate",
    "party": "Republican",
    "trade_count": 401,
    "trade_score": 53,
    "last_trade_date": "2025-11-10"
  },
  {
    "id": 7,
    "name": "Sheldon Whitehouse",
    "chamber": "Senate",
    "party": "Democrat",
    "trade_count": 767,
    "trade_score": 83,
    "last_trade_date": "2025-11-21"
  },
  ...
]
                

GET /v1/senate/transactions

Recent transactions across all Senate members.

Description

Returns recent Senate transactions across all members, filtered by a rolling days window and limited by limit.

Query parameters

Param	Type	Description
limit	integer	Maximum number of transactions to return.
days	integer	Look-back window (in days) from today.

Response

An object with a global count and a list of transaction objects, each including company and politician metadata and the computed disclosure delay.

Response

An array of member objects:

Field	Type	Description
id	integer	Internal identifier for the senator.
name	string	Full name.
chamber	string	Always `Senate` for this endpoint.
party	string	Party affiliation.
trade_count	integer	Total number of parsed transactions.
trade_score	number	Composite score derived from realized/virtual ROI and timing.
last_trade_date	date (YYYY-MM-DD)	Most recent transaction date for this member.

                  cURL
                
curl "https://api.solutionhub.io/v1/senate/transactions?\
limit=100&days=10" \
  -H "Authorization: Bearer <API_TOKEN>"

                  Sample response
                

{
  "Count": 1,
  "Transactions": [
    {
      "Id": 1,
      "Notification Date": "11/27/2025",
      "Transaction Date": "11/25/2025",
      "Disclosure Delay": 2,
      "Owner": "Self",
      "Asset Price": 47.48,
      "Asset Type": "Stock",
      "Type": "Purchase",
      "Amount": "$15,001 - $50,000",
      "Comment": "--",
      "Party": "Republican",
      "Last Trade Date": "2025-11-25",
      "PTR Url": "https://efdsearch.senate.gov/search/view/ptr/...",
      "Transaction Hash": "42c8d5ec6f0...",
      "Company": {
        "Id": 1103,
        "Ticker": "BITB",
        "Name": "Bitwise Bitcoin ETF",
        "Sector": null,
        "Industry": null
      },
      "Politician": {
        "Id": 5,
        "Name": "David H McCormick",
        "Chamber": "Senate"
      }
    }
  ]
}
                

GET /v1/senate/{id}/transactions

Transaction history for a specific senator.

Description

Returns a senator’s transactions, optionally filtered by asset type (stocks vs. others) and limited in count.

Path parameters

Param	Type	Description
id	integer	Senate member `id` from `/v1/senate/members`.

Query parameters

Param	Type	Description
limit	integer	Maximum transactions to return for this member.
typeoptional	string	Asset filter. Known values: `stocks` (stock trades only), `others` (munis, funds, etc.).

                  cURL – stock trades
                
curl "https://api.solutionhub.io/v1/senate/1/transactions?\
limit=10&type=stocks" \
  -H "Authorization: Bearer <API_TOKEN>"

                  cURL – other assets
                
curl "https://api.solutionhub.io/v1/senate/1/transactions?\
limit=10&type=others" \
  -H "Authorization: Bearer <API_TOKEN>"

GET /v1/senate/{id}/positions

Realized and open positions for a senator (with ROI).

Description

Returns the full realized/unrealized position set for a senator, grouped by company. Each position contains all relevant transactions and a realized ROI block when the position has been closed.

Path parameters

Param	Type	Description
id	integer	Senate member `id` from `/v1/senate/members`.

Response

Top-level senator metadata plus a Positions array. Each entry includes:

Company – ticker, name, sector, industry, current price.
Transactions – ordered list of buys/sells with price and amount band.
Realized – true when the position has been fully closed.
ROI – realized ROI percentages and dollar gain when closed.

                  cURL
                
curl "https://api.solutionhub.io/v1/senate/1/positions" \
  -H "Authorization: Bearer <API_TOKEN>"