Docs
Flowseeker/API Reference/Insider

Tickers ranked by insider buying or selling

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

Tickers ranked by how many DISTINCT insiders bought (or sold) in the open market in the window — several insiders buying the same name ("cluster buying") is the pattern this data is read for. One insider filing a position in several lines counts once. Windows are on the filing date, default the last 30 days, and span at most 92 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 filing date (YYYY-MM-DD). Defaults to 30 days before date_end. Max span 92 days.

  • date_endstringdate

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

  • sidestringdefault buy
    buysell
  • sortstringdefault insiders

    insiders ranks by distinct insiders on side, value by USD on side.

    insidersvalue
  • rolestring

    Only count filers claiming this role.

    officerdirectorten_percent_owner
  • min_insidersintegerdefault 1min 1

    Drop tickers with fewer distinct insiders on side.

  • limitintegerdefault 50min 1 · max 500

Responses

  • 200

    Tickers ranked by open-market insider activity.

  • 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
    • buyCountintegerrequired
    • sellCountintegerrequired
    • buyValuenumberdoublerequired

      USD across buy lines that carried a price.

    • sellValuenumberdoublerequired
    • netValuenumberdoublerequired

      buyValue - sellValue.

    • insidersstring[]required

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

    • firstFilingstringdaterequired
    • lastFilingstringdaterequired
  • metarequired

Last updated

Was this page helpful?