Docs
Flowseeker/API Reference/Congress

Tickers ranked by how many members of Congress traded them

GEThttps://api.skylit.ai/v1/congress/top-names

Tickers ranked by DISTINCT members disclosing a buy (or sale) in the window; one member filing several lines counts once. Windows are on the disclosure date, default the last 30 days, and span at most 366 days. meta.totalNames is the number of tickers meeting the filter before limit.

Authorization

Authorization: Bearer <your API key>

Required. A missing header returns 401; an invalid, revoked or expired key returns 403.

Query parameters

  • date_startstringdate

    Inclusive start on the disclosure date (YYYY-MM-DD). Defaults to 30 days before date_end. Max span 366 days.

  • date_endstringdate

    Inclusive end (YYYY-MM-DD). Defaults to today (ET).

  • sidestringdefault buy
    buysellall
  • min_membersintegerdefault 1min 1

    Drop tickers with fewer distinct members on side.

  • limitintegerdefault 50min 1 · max 500

Responses

  • 200

    Tickers ranked by distinct members.

  • 400

    Request validation failed.

  • 401

    Missing or invalid API key.

  • 402

    The account's shared Skylit credit balance is lower than this route's cost. Top up to continue. Carries X-Credits-Remaining: 0.

  • 403

    Unknown, revoked or expired API key (the gateway's forbidden), the account's API access is suspended (account_suspended) or blocked (account_blocked). Not retryable.

  • 429

    Either the key exceeded its requests-per-minute limit (X-RateLimit-Limit; no Retry-After, wait until X-RateLimit-Reset), or the account is over one of the API's own limits, such as the query budget (queries running at once, fresh queries per second): TOO_MANY_CONCURRENT_QUERIES or RATE_LIMITED with Retry-After. Not charged; retry after the wait.

  • 500

    Unexpected server error (INTERNAL_ERROR, DATABASE_ERROR). Not charged; safe to retry with exponential backoff.

  • 503

    Underlying data source temporarily unavailable, the credit balance could not be verified (credit_check_failed), or the API is paused for maintenance (api_paused, with a Retry-After header and a retry_after field in seconds). Not charged; safe to retry.

  • 504

    The request did not complete within 25 seconds. Not charged; narrow the window or retry.

Response fields

  • dataobject[]required
    • tickerstringrequired
    • distinctBuyersintegerrequired
    • distinctSellersintegerrequired
    • distinctMembersintegerrequired
    • buyCountintegerrequired
    • sellCountintegerrequired
    • buyLownumberdoublerequired
    • buyHighnumberdoublerequired
    • buyHighIsFloorbooleanrequired
    • sellLownumberdoublerequired
    • sellHighnumberdoublerequired
    • sellHighIsFloorbooleanrequired
    • otherCountintegerrequired
    • hasHousebooleanrequired
    • hasSenatebooleanrequired
    • membersstring[]required

      Members on the ranked side, alphabetically, at most 12.

    • firstDisclosurestringdaterequired
    • lastDisclosurestringdaterequired
  • metarequired

Last updated

Was this page helpful?