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. An ISO weekly period is a durable canonical snapshot; an explicit weekly from,to pair is an exact ephemeral range limited to 31 inclusive UTC days and never creates a persisted snapshot identity. A wider explicit range returns 400 invalid_query. 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 for a durable canonical snapshot, or a from,to YYYY-MM-DD pair for an exact ephemeral range limited to 31 inclusive UTC days. A wider explicit range returns 400 invalid_query. monthly: UTC month YYYY-MM.

Headers

X-Query-Validation'strict'

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Response

Daily report snapshot

object'report_snapshot' required

Changes

Changed in 19 of the 89 revisions of this API.10209215

Sep 23, 2026ece7a25b7a4499See the full diff
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 23, 20268462acf80f8c94See the full diff
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 22, 202619386d595e0521See the full diff
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
Sep 22, 20261c5e270b412491See the full diff
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new optional header request parameter X-Query-Validation
  new-optional-request-parameter
Sep 22, 20269958c95371de18See the full diff
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
Sep 22, 202627406a84a3401See the full diff
- ○
  added the required property // to the response with the status
  response-required-property-added
Sep 22, 2026f0c4da7369371See the full diff
- ▲
  the response property const value whale_alerts.usdc_notional_num was removed for the status
  response-property-const-removed
Sep 22, 20264bade829e22818See the full diff
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
Sep 22, 2026053eabfb300f3See the full diff
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Sep 22, 20267b5489c2cd3e561See the full diff
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the media type application/json for the response with the status
  response-media-type-added

Full history (19 revisions)