Congressional Trades by Politician

Us Congress Trades Politician Trades

curl --request GET \
  --url https://socialquery.dev/v1/us_congress_trades/politician/trades \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://socialquery.dev/v1/us_congress_trades/politician/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "items": [
      {
        "id": "<string>",
        "url": "<string>",
        "issuer": {
          "id": "<string>",
          "name": "<string>",
          "ticker": "<string>",
          "sector": "<string>"
        },
        "politician": {
          "id": "<string>",
          "first_name": "<string>",
          "last_name": "<string>",
          "display_name": "<string>",
          "party": "<string>",
          "state": "<string>",
          "chamber": "<string>"
        },
        "pub_date": "<string>",
        "tx_date": "<string>",
        "tx_type": "<string>",
        "owner": "<string>",
        "reporting_gap_days": 1,
        "value_estimate_usd": 1,
        "price_usd": 123
      }
    ],
    "returned_count": 1,
    "total": 1,
    "handle": "<string>",
    "politician": {
      "id": "<string>",
      "name": "<string>"
    },
    "sort": "pub_date",
    "order": "asc",
    "limit": 50,
    "offset": 1,
    "has_more": true,
    "next_cursor": "<string>",
    "source": "<string>",
    "coverage_note": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

GET

us_congress_trades

politician

trades

Us Congress Trades Politician Trades

curl --request GET \
  --url https://socialquery.dev/v1/us_congress_trades/politician/trades \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://socialquery.dev/v1/us_congress_trades/politician/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "items": [
      {
        "id": "<string>",
        "url": "<string>",
        "issuer": {
          "id": "<string>",
          "name": "<string>",
          "ticker": "<string>",
          "sector": "<string>"
        },
        "politician": {
          "id": "<string>",
          "first_name": "<string>",
          "last_name": "<string>",
          "display_name": "<string>",
          "party": "<string>",
          "state": "<string>",
          "chamber": "<string>"
        },
        "pub_date": "<string>",
        "tx_date": "<string>",
        "tx_type": "<string>",
        "owner": "<string>",
        "reporting_gap_days": 1,
        "value_estimate_usd": 1,
        "price_usd": 123
      }
    ],
    "returned_count": 1,
    "total": 1,
    "handle": "<string>",
    "politician": {
      "id": "<string>",
      "name": "<string>"
    },
    "sort": "pub_date",
    "order": "asc",
    "limit": 50,
    "offset": 1,
    "has_more": true,
    "next_cursor": "<string>",
    "source": "<string>",
    "coverage_note": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

Returns public disclosures from the Capitol Trades index for handle=Pelosi, a full display name such as Nancy Pelosi, or a native member ID such as P000197. A surname must resolve to one indexed member and agree with returned disclosure surnames. Ambiguous surnames return 422; use the full display name or member ID. Unindexed members return an empty result. This directory reflects the source index, not a complete current Congress roster. sort accepts pub_date (default), tx_date, reporting_gap and value; order is asc or desc (default). Dates and delay use native source ordering, corroborated across every fetched row. Value sorting is supported only when the member’s complete indexed history fits in 100 disclosures. The adapter fetches that complete result, then sorts and slices it. Larger histories return an unbilled 422 UNSUPPORTED_PARAMETER; a partial page is never presented as globally sorted. Use limit 1–100 (default 20), offset 0–1,000,000, or a returned next_cursor alone. Cursors bind member, sort/order, size and offset for one hour and recheck the preceding trade. New or edited source records can require restarting. Use a full display name/member ID for a terminal offset without a previous surname-verified cursor: an empty source page cannot independently corroborate a surname. The source says its available history is restricted to the past three years. total means the current indexed matching count, not lifetime filings or complete government coverage. Rows preserve source IDs, member name/party/state/chamber, issuer/ticker/sector, publication and trade dates, transaction type, owner, reporting gap, estimated value and nullable price. Values are estimates. Birth dates and gender are omitted. Requests reuse the existing Firecrawl basic transport: one anonymous public directory read and at most two disclosure pages, a shared 55-second deadline, a 4 MiB decoded HTML limit per page and 20 source reads/minute. Page data is parsed without executing scripts. No new account, key or purchase is required. A fresh nonempty response costs 1 credit. Empty results, errors, cached responses and successful idempotent replays cost zero. Use X-Max-Credits: 1. Existing approved provider free allowance only.

Authorizations

x-api-key

string

header

required

Headers

Cache-Control

string

Idempotency-Key

string

X-Max-Credits

integer

Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero.

Required range: x >= 0

Query Parameters

handle

string

Unambiguous member surname (corroborated against disclosures), full source display name or native member ID. Alternatively supply a returned cursor.

sort

enum<string>

Default pub_date. Value sort requires the complete indexed member history to fit in 100 disclosures; larger histories return 422 UNSUPPORTED_PARAMETER without charge.

Available options:

pub_date,

tx_date,

value,

reporting_gap

order

enum<string>

asc or desc (default desc).

Available options:

asc,

desc

limit

integer

1–100 rows, default 20.

Required range: 1 <= x <= 100

offset

integer

Rows to skip, 0–1000000. Prefer next_cursor. Use full display name/member ID to verify a terminal window without prior surname evidence.

Required range: 0 <= x <= 1000000

cursor

string

One-hour cursor, usable alone. Binds member, sort/order and size; checks the previous disclosure. Source changes require restarting.

Response

Public Capitol Trades disclosures for an unambiguous member surname, full display name or native member ID. Supports publication/transaction-date/reporting-delay sorts and complete-result value sorting for members with at most 100 indexed disclosures. The source limits history to three years. One-hour cursors bind identity, sort and window. Empty results are free; ambiguous identities and unavailable source data fail closed.

success

boolean

required

platform

string

required

endpoint

string

required

credits_used

integer

required

Required range: x >= 0

credits_remaining

integer | null

required

request_id

string

required

cached

boolean

required

data

object

required

The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.

Show child attributes