Bestseller
Stock Market US Equities
US Stock Symbols Directory
Paginated and searchable directory of US stock ticker symbols and company names
Data & API Features
Paginated and searchable US stock symbol lookup;
Partial matching by ticker symbol or company name;
Maximum 20 symbols per page with normalized pagination input;
Returns ticker symbol and company name only;
Stable symbol directory for downstream US stock APIs;
Suitable for symbol pickers, validation, and data joins;
Full HTTPS support (TLS v1.0 / v1.1 / v1.2 / v1.3);
Apple App Transport Security (ATS) compliant;
Annual Subscription
$49$99
Try it for free!
Sign In Sign in to get a trial key and test all APIs.
Secure payment 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
Full API Docs:developers.gugudata.io
API Request Parameters
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | YOUR_APPKEY | APPKEY obtained after subscription |
| query | string | false | Search keyword for partial matching against ticker symbol or company name | |
| pageIndex | integer | false | 1 | Page number for pagination (starts from 1) |
| pageSize | integer | false | 20 | Number of records per page (valid range: 1-20, values outside the range are normalized to 20) |
API Response Parameters
| Name | Type | Remark |
|---|---|---|
| dataStatus | object | Response status information |
| dataStatus.requestParameter | string | Echo of normalized request parameters |
| dataStatus.statusCode | integer | HTTP status code of the response |
| dataStatus.statusDescription | string | Human-readable status message |
| dataStatus.responseDateTime | string | Server response timestamp |
| dataStatus.dataTotalCount | integer | Total number of records matching the query |
| data | array | Paginated list of US stock ticker symbols |
| data[].symbol | string | US stock ticker symbol |
| data[].stockName | string | Company name returned by Gugudata |
API Response Status Codes
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 200 | API responding normally | For business status codes, see below under API Custom Status Codes. |
| 400 | Parameter error | |
| 402 | APPKEY error | Please check if the APPKEY provided is the one obtained from the developer center. |
| 403 | Account overdue | Please pay attention to the E-mail reminders regarding order expiration. |
| 429 | Request rate limited | Requests cannot exceed 5 times per second. The CDN layer intelligently determines based on the frequency of IP requests. General high-frequency requests do not trigger this status code. |
| 500 | API response error |
