Get symbol company metadata
GET/v1/symbols/{symbol}

Get symbol company metadata

Retrieves comprehensive company metadata, exchange, sector, industry, description, and website.

Endpoint Usage & Plan Rules

Plan Access
Included in Basic
Active subscription
Rate Limit
One request per call; no daily quota
Result Clamping
Not Clamped
Full response returned

Parameters

Required Parameters

NameTypeLocationDescription
symbolstringpathUnderlying equity ticker symbol (e.g. AAPL).

Request Examples

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

Try it

GET/v1/symbols/{symbol}
Included in Basic

Requests run against the live API with your key and count against its rate limits. The key is sent only to this site. Sign in to get a key

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)

FieldTypeNullableDescription
symbolstringNoStock ticker symbol.
namestringNoCompany name.
exchangestringNoListing stock exchange.
websitestringNoCompany website.
descriptionstringNoCompany business overview.
countrystringNoCountry of incorporation or headquarters.
industrystringNoIndustry classification.
sectorstringNoSector classification.
marketCapnumberYesMarket capitalization in USD.
peRationumberYesPrice to earnings ratio.
fiftyTwoWeekLownumberYes52-week low price.
fiftyTwoWeekHighnumberYes52-week high price.
earningsDatestringYesUpcoming or latest reported earnings date (YYYY-MM-DD).
updatedAtstringYesISO 8601 UTC timestamp of last metadata or price update.

Error Responses

StatusDescription
400Bad Request. The request body, query parameters, or path values violated validation constraints.
401Unauthorized. Missing, malformed, or invalid API key credential.
403Forbidden. Rejection reasons: `subscription_required`, `subscription_inactive`, `trial_ended`, `plan_upgrade_required` (with `required_plan`), `wrong_credential_type`, `origin_forbidden` (origin authentication failed).
404Not Found. Requested resource, ticker symbol, or option contract does not exist.
405Method 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.)
429Too Many Requests. Rejection reasons: `rate_limited` (exceeded per-minute rate limit or per-IP rate limit), `too_many_auth_failures` (edge lockout).
500Internal Server Error. Unhandled internal server or database error.
Search symbols and company namesGet daily stock OHLC candle bars