Docs
Flowseeker/API Reference/Congress

One ticker's congressional trading disclosures

GEThttps://api.skylit.ai/v1/underlying/{ticker}/congress

STOCK Act periodic transaction reports naming {ticker}, newest disclosure first, with a summary over the whole window. Amounts are the filed brackets, so the summary carries the sum of bracket floors and ceilings per side and no net. Windows are on the DISCLOSURE date; defaults to the last 730 days (data starts August 2024).

Authorization

Authorization: Bearer <your API key>

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

Path parameters

  • tickerstringrequired

    Underlying ticker symbol (uppercase, e.g. SPY, AAPL).

Query parameters

  • date_startstringdate

    Inclusive start on the disclosure date (YYYY-MM-DD). Defaults to 730 days before date_end.

  • date_endstringdate

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

  • limitintegerdefault 200min 1 · max 2000
  • offsetintegerdefault 0min 0 · max 10000

Responses

  • 200

    Summary and disclosure lines for {ticker}.

  • 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.

  • 404

    Unknown ticker or contract (SYMBOL_NOT_FOUND), or no data for the requested window. Not charged.

  • 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

  • dataobjectrequired
    • summaryobjectrequired

      The window's disclosures, independent of limit and offset. Dollar figures are sums of bracket bounds, never amounts, so there is no net.

    • tradesobject[]required

      Disclosure lines, newest disclosure first.

  • metarequired

Last updated

Was this page helpful?