GET/v1/usage

Get account usage and limits

Account usage metrics and rate limits.

Endpoint Usage & Plan Rules

Plan Access

All Plans

No subscription required

Rate Limit

Your plan's per-minute limit

One request per call; no daily quota

Result Clamping

Not Clamped

Full response returned

Request Examples

curl -s -H "Authorization: Bearer $WSO_API_KEY" \
  "https://api.wheelstrategyoptions.com/v1/usage"

Try it

GET/v1/usage

Any account

Add your API key to send.

Response

Send a request to see the live response, its status, timing, and rate-limit headers.

Response Attributes (200 OK)

Field	Type	Nullable	Description
plan	string	Yes	Current active plan id (for example 'basic'), or null.
subscription_status	string	Yes	Subscription status string ('active', 'trialing', 'past_due', etc.).
entitled	boolean	No	Whether the account is currently entitled to execute paid API operations.
date	string	No	Current date in America/New_York (YYYY-MM-DD format) defining the counting day for requests.today.
rate_limit	any	No	Rate limiting configuration, null if account has no active plan.
concurrency	any	No	Concurrency limitation configuration, null if account has no active plan.
requests	any	No	Daily request usage breakdown, null if account has no active plan.

Response Example

json

{
  "plan": "basic",
  "subscription_status": "active",
  "entitled": true,
  "date": "2026-10-10",
  "requests": {
    "today": 42,
    "reset_at": "2026-10-11T04:00:00Z",
    "reset_unix": 1791691200
  },
  "rate_limit": {
    "requests_per_minute": 300
  },
  "concurrency": {
    "max": 5
  }
}

Error Responses

Status	Description
401	Unauthorized. Missing, malformed, or invalid API key credential.
403	Forbidden. Rejection reasons: `wrong_credential_type` (session token presented on API route), `origin_forbidden` (origin authentication failed).
404	Not Found. Requested resource, ticker symbol, or option contract does not exist.
405	Method Not Allowed. Returned with an `Allow` header when an unsupported HTTP method is used. Error code: `method_not_allowed`. (HEAD is served on all GET routes and counts against the rate limit like GET.)
429	Too Many Requests. Rejection reasons: `rate_limited` (exceeded per-minute rate limit or per-IP rate limit), `too_many_auth_failures` (edge lockout).
500	Internal Server Error. Unhandled internal server or database error.
503	Service Unavailable. Backing database, cache, or external provider connection unavailable.

Verify credentials and entitlement Get equity spot price quote