Usage Cost
5 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/finance-us-shares-symbolcURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/finance-us-shares-symbol' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "market": "市场,au 美交所 ,nu 纽交所 ,ou 纳斯达克"\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/finance-us-shares-symbol"
payload = {
"market": "市场,au 美交所 ,nu 纽交所 ,ou 纳斯达克"
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())Go Example
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/finance-us-shares-symbol"
payload := []byte("{\n \"market\": \"市场,au 美交所 ,nu 纽交所 ,ou 纳斯达克\"\n}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java Example
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"market\": \"市场,au 美交所 ,nu 纽交所 ,ou 纳斯达克\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/finance-us-shares-symbol"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP Example
<?php
$endpoint = 'https://openapi.toolkk.com/v1/finance-us-shares-symbol';
$payload = "{\n \"market\": \"市场,au 美交所 ,nu 纽交所 ,ou 纳斯达克\"\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;Response Example
{
"msg": "成功",
"code": 200,
"taskNo": "644761017176228998465587",
"data": {
"list": [
{
"symbol": "gdxu",
"name": "金矿指数3倍做多ETN"
},
{
"symbol": "evav",
"name": "2倍做多电动和自动驾驶汽车ETF-Direxion"
}
]
}
}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
Request Fields
Fields are read from the API schema. Missing descriptions and examples are marked as unspecified.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| market | string | Yes | 市场,au 美交所 ,nu 纽交所 ,ou 纳斯达克 | Unspecified |
Request Example
{
"market": "市场,au 美交所 ,nu 纽交所 ,ou 纳斯达克"
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
Response Fields
Fields are read from the API schema. Missing descriptions and examples are marked as unspecified.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| msg | string | No | 返回码对应描述 | 成功 |
| code | number | No | 返回码,详见返回码说明 | 200 |
| taskNo | string | No | 本次请求号 | 644761017176228998465587 |
| data | object | No | Unspecified | Unspecified |
| data.list | array | No | Unspecified | [{"symbol":"gdxu","name":"金矿指数3倍做多ETN"},{"symbol":"evav","name":"2倍做多电动和自动驾驶汽车ETF-Direxion"}] |
| data.list[] | object | Unspecified | Unspecified | Unspecified |
Response Example
{
"msg": "成功",
"code": 200,
"taskNo": "644761017176228998465587",
"data": {
"list": [
{
"symbol": "gdxu",
"name": "金矿指数3倍做多ETN"
},
{
"symbol": "evav",
"name": "2倍做多电动和自动驾驶汽车ETF-Direxion"
}
]
}
}API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Introduction
This API is used to retrieve the list of trading symbols for specified US stock markets. By passing a market code (e.g., NYSE, NASDAQ, or AMEX), it returns the corresponding stock symbol and its Chinese name. The data is suitable for building a basic US stock market database or a frontend stock picker.
Use Cases
- Financial Terminal Development: Initialize US stock dropdown selectors or search indexes.
- Quantitative Strategy Backtesting: Obtain the full universe of symbols for a specific exchange, used for filtering tradable assets.
- Information Aggregation Applications: Establish a mapping between stock symbols and Chinese names to enhance user reading experience.
Request and Response Description
- Request Method: POST
- Core Parameter:
market(Required), enum values includenu(NYSE),ou(NASDAQ),au(AMEX).