Reports

Unified report snapshot (granularity selector)

Unified convenience route (#4975) that consolidates the three singular report routes. Dispatches to the exact per-granularity cap (daily 50, weekly 100, monthly 200) and date window the legacy /api/v1/reports/{daily,weekly,monthly} routes use, so the response body is byte-identical to the matching legacy route for the same period. The three legacy routes stay live. Also reachable via the MCP get_report selector.

get/api/v1/reports

Query parameters

granularity'daily' | 'weekly' | 'monthly' required

Report granularity selector.

periodstring required

Period token for the granularity. daily: UTC date YYYY-MM-DD. weekly: ISO week YYYY-WW, or a from,to YYYY-MM-DD pair. monthly: UTC month YYYY-MM.

Response

Daily report snapshot

object'report_snapshot' required

Changes

Changed in 6 of the 31 revisions of this API.24175

Aug 29, 20267c0c7cdd41ee8See 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 500
  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
Aug 29, 20268582a359fa0719See 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 500 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 500 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 503 status
  response-optional-property-added
- ○
  added the required property data/snapshot/version to the response with the 200 status
  response-required-property-added
Jul 30, 202619193b1771541699See 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 500
  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 500
  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 500 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 500 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 500 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 500 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 500 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 500 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 500 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 500 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 500 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 500 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 500 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
Jul 14, 202622ab6cfbf30043See the full diff
- ○
  added the optional property error/reason to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 503 status
  response-optional-property-added
- ○
  added the required property meta/cost to the response with the 200 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 400 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 401 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 402 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 403 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 423 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 429 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 500 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 503 status
  response-required-property-added
Jul 1, 20261777a41bfb5313See the full diff
- ○
  added the optional property data/report/top_whale_trades/items/id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/market_category to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/name to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/outcome to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/platform to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/price to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/pseudonym to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/side to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/size to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/title to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/token_id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/trade_time to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/report/top_whale_trades/items/trader_grade to the response with the 200 status
  response-optional-property-added
Jun 15, 20265b6d6ff7692c1See the full diff
- ○
  endpoint added
  endpoint-added

Full history