Usage

Inspect current API usage without spending primary request quota

Changed on Sep 23, 2026

Returns the authenticated caller sliding-window request budget, UTC-day usage and monthly quota. This control-plane endpoint remains available for a valid credential after paid data access lapses and does not increment the primary Redis rate-limit counter, monthly quota or API usage table; it shares a separate 100 reads/minute per-user inspection bucket with GET /api/v1/me. UTC-day totals use finalized quarter-hour rollups plus the disjoint raw interval through request time; unavailable rollup progress returns an error.

get/api/v1/usage

Request

Base URL
https://api.0xinsider.com
Auth
- HTTP bearer
- or OAuth 2
  Authorization codehttps://0xinsider.com/oauth/authorize
  Token URLhttps://api.0xinsider.com/oauth/token
  Scopesusage
TypeScript
https://skmtc.dev/0xinsider/apis/0xinsider-api/docs/api/v1/usage/get.ts
A function with typed inputs. Its response is checked against the schema.

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

Usage budget and counters for the authenticated API key owner.

object'usage' required

Example response

{
  "data": {
    "rate_limit": {
      "used": 7,
      "limit": 100,
      "remaining": 93,
      "reset_at": 1710772860,
      "window_seconds": 60
    },
    "daily_usage": {
      "used": 42,
      "reset_at": 1710806400,
      "window_seconds": 86400
    },
    "monthly_quota": {
      "used": 41230,
      "limit": 250000,
      "remaining": 208770,
      "reset_at": 1793491200,
      "enforced_from": 1790812800,
      "ceiling": 250000
    }
  }
}

Changes

Sep 23, 2026ece7a25b7a44 Revision changes
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Sep 23, 20268462acf80f8c Revision changes
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status

Operation history (19 revisions)