Bestseller
Stock Market US Equities

US Stock Symbols Directory

Search US stock symbols and company names

What can this API do?

Ticker lookup

Find US stock symbols for search forms and reference workflows.

Company name search

Search by a company name substring with case-insensitive matching.

Paginated results

Browse up to 20 entries per page in symbol order.

Matching totals

Read the matching record total independently of the current page size.

Structured records

Receive symbol and company-name fields in a JSON array.

Reference workflows

Use directory results in your own lookup and data-review applications.

US Stock Symbols Directory
Annual plan
$49$99
Try it for free!
Sign in to get a trial key and test all APIs.
Sign In
Secure checkout powered by Stripe

API Document

HTTP Protocol:HTTPS

HTTP Method:GET

HTTP Endpoint:https://api.gugudata.io/v1/stock/us/symbols

Response Type:application/json; charset=utf-8

DEMO Endpoint:https://api.gugudata.io/v1/stock/us/symbols/demo

Live Demo:Try Interactive Demo

Postman Collection:Run in Postman

API Request Parameters

NameTypeIs RequiredDefault ValueRemark
appkeystringtrueYOUR_APPKEY API key used to authenticate the request.
querystringfalse Search keyword used for partial matching against the documented dataset fields.
pageIndexintegerfalse1 One-based page index for pagination.
pageSizeintegerfalse20 Number of records returned per page.

API Response Parameters

NameTypeRemark
dataStatusobject Legacy response metadata. `dataStatus.statusCode` is not the HTTP status code for this endpoint family.
dataStatus.requestParameterstring Privacy-safe summary of the normalized request.
dataStatus.statusCodeinteger Application-level status code.
dataStatus.statusDescriptionstring Human-readable application status message.
dataStatus.responseDateTimestring Time at which the response was generated.
dataStatus.dataTotalCountinteger Number of matching or returned records for this request.
dataarray<string> Primary response payload returned by the endpoint.
data[].symbolstring US stock ticker symbol.
data[].stockNamestring English company name returned by the upstream dataset.

API Response Status Codes

Status CodeExplanation of Status CodeRemarks
200Request processed successfully.Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`.
400Invalid request parameters or request format.Check required fields, data types, and request body format.
401Missing or unknown application key.Provide a valid `appkey` with the request.
403The application key is recognized but access is not allowed.The key may be expired, inactive, or not permitted for the requested API.
429Request rate or trial usage limit exceeded.Reduce concurrency or retry after the limit window resets.
500Internal service error.Retry later or contact support if the error persists.
503Upstream service unavailable.Retry later; the requested upstream dependency is temporarily unavailable.

Remote MCP

AI client access

Use this API through GuGuData Remote MCP

Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.

Endpoint https://mcp.gugudata.io/mcp
Open MCP Guide
Generic MCP configuration
{
  "mcpServers": {
    "gugudata": {
      "url": "https://mcp.gugudata.io/mcp",
      "transportType": "streamable-http"
    }
  }
}

Code Snippets