Congressional Trades by Ticker

Us Congress Trades Ticker Trades

curl --request GET \
  --url https://socialquery.dev/v1/us_congress_trades/ticker/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/ticker/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,
    "keyword": "<string>",
    "issuer": {
      "id": "<string>",
      "name": "<string>",
      "ticker": "<string>"
    },
    "filters": {
      "party": "<string>",
      "chamber": "<string>",
      "tx_type": "<string>",
      "start_date": "<string>",
      "end_date": "<string>"
    },
    "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

ticker

trades

Us Congress Trades Ticker Trades

curl --request GET \
  --url https://socialquery.dev/v1/us_congress_trades/ticker/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/ticker/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,
    "keyword": "<string>",
    "issuer": {
      "id": "<string>",
      "name": "<string>",
      "ticker": "<string>"
    },
    "filters": {
      "party": "<string>",
      "chamber": "<string>",
      "tx_type": "<string>",
      "start_date": "<string>",
      "end_date": "<string>"
    },
    "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 STOCK Act disclosures from the Capitol Trades index for an exactly resolved issuer. Supply keyword=AAPL or keyword=AAPL:US; bare tickers default to :US. The anonymous public issuer directory must return a complete, unambiguous exact match. An unindexed ticker returns an empty result with issuer: null; an incomplete or ambiguous lookup fails without charging. Optional filters are party (democrat/republican), chamber (house/senate), tx_type (buy/sell/exchange), and inclusive start_date/end_date in YYYY-MM-DD format. Dates filter publication dates, not transaction dates. Results use descending publication order. Omitted start/end bounds use 1900-01-01/the request’s UTC date when a date filter is present. Use limit (1–100; default 20) and offset (0–1,000,000), or a returned next_cursor alone. Cursors bind the resolved issuer, all filters, window size and offset for one hour and recheck the preceding trade ID. Source edits or added filings can require restarting. Totals describe the current indexed matching disclosures, not lifetime trading activity or complete government coverage. Rows preserve native IDs, politician name/party/state/chamber, issuer/ticker/sector, publication timestamp, trade date, transaction type, owner label, reporting gap, estimated value and nullable price. Disclosed values are source estimates, not exact transaction amounts. Birth dates and gender are omitted. Every row must agree with the requested filters and rendered trade links. The adapter makes one anonymous issuer lookup and at most two native 100-row page reads through the existing Firecrawl basic transport. It has a shared 55-second timeout, a 1 MiB issuer-response limit, a 4 MiB decoded HTML limit per page and 20 source reads/minute. Original page scripts are parsed as data without execution. No new account or key is required. A fresh nonempty response costs 1 credit. Empty results, errors, cache hits and successful idempotent replays cost zero. Use X-Max-Credits: 1. Provider requests stay within the existing approved Firecrawl free allowance; no paid plan or replenishment is enabled.

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

keyword

string

Bare ticker or source ticker with two-letter market suffix; bare symbols default to :US. Alternatively supply a returned cursor.

chamber

enum<string>

Available options:

senate,

house

party

enum<string>

Available options:

democrat,

republican

tx_type

enum<string>

Available options:

buy,

sell,

exchange

start_date

string<date>

Inclusive disclosure publication date, YYYY-MM-DD; this is not the transaction date.

end_date

string<date>

Inclusive disclosure publication date, YYYY-MM-DD; this is not the transaction date.

limit

integer

1–100 rows, default 20.

Required range: 1 <= x <= 100

offset

integer

Rows to skip, 0–1000000. Prefer next_cursor.

Required range: 0 <= x <= 1000000

cursor

string

One-hour next_cursor, usable alone. Binds resolved ticker, filters and size and verifies the preceding disclosure. Source changes require restarting.

Response

Public Capitol Trades indexed disclosures for an exact ticker. Bare symbols default to :US. Supports party/chamber/type and publication-date filters, 1–100-row windows, offset up to 1000000 and a one-hour bound cursor. Totals describe the current index, not lifetime coverage. Incomplete or ambiguous issuer lookups fail closed; unindexed tickers and empty pages are free.

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