Sign in
Markets

List ranked sharp-money flows

Canonical alias of /api/v1/markets/smart-money-flows, which remains live but deprecated. Ranks markets by absolute net S/A/B-grade whale flow over a requested timeframe. Use this discovery endpoint to answer where sharp money is flowing before drilling into a specific market with /api/v1/market/{condition_id}/intel. Pagination is anchored by an opaque cursor carrying the first page as_of timestamp so new whale trades do not reorder page 2.

get/api/v1/markets/sharp-money-flows

Query parameters

timeframe'1h' | '4h' | '24h' | '7d'

Lookback window for grade-filtered whale flow aggregation.

limitinteger

Page size.

cursorstring

Opaque cursor from previous response's next_cursor. Encodes the first-page as_of timestamp plus the last row's absolute net flow and condition_id.

categorystring

Filter by market category (case-insensitive). A canonical bucket name (e.g. Basketball) matches every provider member that folds into it (NBA, WNBA, NCAAB); a raw provider value also resolves to its bucket.

platform'polymarket' | 'kalshi' | 'all'

Filter by source platform. all is a request-side no-op.

min_grade'S' | 'A' | 'B' | 'C' | 'D' | 'F'

Minimum latest trader grade included in the flow. Default B means S/A/B only; unranked traders are excluded.

direction'YES' | 'NO'

Optional post-aggregate flow direction filter.

Headers

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

Ranked market sharp-money flows

object'list' required
has_moreboolean required
next_cursorstring nullable
totalinteger nullable

Changes

Changed in 4 of the 31 revisions of this API.21105

  • 7c0c7cdd41ee7See the full diff
    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 402

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 423

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 503

      response-property-enum-value-added

  • 8582a359fa0716See the full diff
    • ○

      added the optional property meta/ranking_as_of to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 503 status

      response-optional-property-added

  • 19193b1771541488See the full diff
    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 402

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 423

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 503

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 402

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 423

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 503

      response-property-enum-value-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 503 status

      response-optional-property-added

  • 22ab6cfbf3001See the full diff
    • ○

      endpoint added

      endpoint-added