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.

Productivity
0.5 credits/call

Pricing

0.5 credits/call
ConditionCharge
Each call0.5 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
cikstringNoThe CIK of an instrument for which data is requested—
isinstringNoISIN of the instrument. Use a real non-empty identifier; if this instrument is unavailable by ISIN, resolve its ticker symbol first.—
pageintegerNoZero-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
typeenum (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)NoThe asset class to which the instrument belongs—
cusipstringNoCUSIP of the instrument. Use a real non-empty identifier; if this instrument is unavailable by CUSIP, resolve its ticker symbol first.—
formatenum (JSON | CSV)NoThe format of the response dataJSON
symbolstringNoThe ticker symbol of an instrument for which data is requested—
countrystringNoFilter by country name or alpha code, e.g., `United States` or `US`—
exchangestringNoFilter by exchange name—
mic_codestringNoFilter by market identifier code (MIC) under ISO 10383 standard—
delimiterstringNoThe separator used in the CSV response data;
show_planbooleanNoAdds info on which plan symbol is availablefalse
outputsizeintegerNoNumber 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_delistedbooleanNoInclude delisted identifiersfalse

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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
JSONPartial content
{
  "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.