Twelve Data Get Stocks
0.5 credits/call
ae_twelvedata_get_stocks
Browse Twelve Data’s daily updated list of available stock symbols, with filters for exchange, country, asset type, and identifiers.
0.5 credits/call
Pricing
0.5 credits/call
| Condition | Charge |
|---|---|
| Each call | 0.5 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
cik | string | No | The CIK of an instrument for which data is requested | — |
isin | string | No | ISIN of the instrument. Use a real non-empty identifier; if this instrument is unavailable by ISIN, resolve its ticker symbol first. | — |
page | integer | No | Zero-based page index when outputsize is provided: 0 is the first page, 1 is the second page, and so on. Use page together with outputsize for pagination. For an exact single-symbol lookup, omit pagination unless needed. | 0 |
type | enum (American Depositary Receipt | Bond | Bond Fund | Closed-end Fund | Common Stock | Depositary Receipt | Digital Currency | ETF | Exchange-Traded Note | Global Depositary Receipt | Limited Partnership | Mutual Fund | Physical Currency | Preferred Stock | REIT | Right | Structured Product | Trust | Unit | Warrant) | No | The asset class to which the instrument belongs | — |
cusip | string | No | CUSIP of the instrument. Use a real non-empty identifier; if this instrument is unavailable by CUSIP, resolve its ticker symbol first. | — |
format | enum (JSON | CSV) | No | The format of the response data | JSON |
symbol | string | No | The ticker symbol of an instrument for which data is requested | — |
country | string | No | Filter by country name or alpha code, e.g., `United States` or `US` | — |
exchange | string | No | Filter by exchange name | — |
mic_code | string | No | Filter by market identifier code (MIC) under ISO 10383 standard | — |
delimiter | string | No | The separator used in the CSV response data | ; |
show_plan | boolean | No | Adds info on which plan symbol is available | false |
outputsize | integer | No | Number of records per page. Combine with page=0 for the first page, then page=1, page=2, etc. Page and outputsize are not mutually exclusive. If omitted, all matching available records may be returned. | — |
include_delisted | boolean | No | Include delisted identifiers | false |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_twelvedata_get_stocks' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"country": "France",
"show_plan": true,
"symbol": "MC"
}
}'Response exampleresponse.json
{
"count": 1,
"data": [
{
"access": {
"global": "Grow",
"plan": "Grow",
"plan_business": "Venture"
},
"cfi_code": "ESVUFR",
"country": "France",
"currency": "EUR",
"name": "LVMH Moët Hennessy Louis Vuitton SE",
"type": "Common Stock"
}
],
"status": "ok"
}This example shows part of the response. Copied content is valid JSON.

