Search symbols and company names
GET/v1/symbols/search

Search symbols and company names

Searches for matching stock tickers and company names.

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
qstringquerySearch query string (ticker symbol prefix or company name substring).

Optional Parameters

NameTypeLocationDescription
limitintegerqueryMaximum number of results to return (1-100, default 20).

Request Examples

curl -s -H "Authorization: Bearer $WSO_API_KEY" \
  "https://api.wheelstrategyoptions.com/v1/symbols/search?q=Apple&limit=10"

Try it

GET/v1/symbols/search
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
resultsobject[]NoList of matching symbols.

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).
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.
502Bad Gateway. Upstream market data provider failure.
503Service Unavailable. Backing database, cache, or external provider connection unavailable.
Get batch equity spot quotesGet symbol company metadata