Twelve Data Get Quote
0.5 credits/call
ae_twelvedata_get_quote
Get a detailed Twelve Data market quote, including the latest price, open, high, low, close, volume, and price change. Connection coverage: supports US equity data, forex and cryptocurrency data, end-of-day or historical data for selected international markets; excludes data requiring a higher subscription or separate entitlement. A catalog entry does not prove authorization through this connection.
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 |
|---|---|---|---|---|
dp | integer | No | Specifies the number of decimal places for floating values Should be in range [0,11] inclusive | 5 |
eod | boolean | No | If true, return data for a closed trading day. Only supported when interval is 1day or omitted (defaults to 1day). For any other interval, omit eod or set it to false; eod=true with a non-daily interval returns an upstream error. | false |
isin | string | Conditional | ISIN of the instrument. Use a real non-empty identifier; if this instrument is unavailable by ISIN, resolve its ticker symbol first. | — |
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 | Conditional | 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 | Value can be JSON or CSV Default JSON | JSON |
symbol | string | Conditional | Ticker symbol of the instrument, for example AAPL, EUR/USD or ETH/BTC. Use a real non-empty symbol; a supported ISIN or CUSIP may be used instead when this endpoint accepts it. Connection coverage: supports US equity data, forex and cryptocurrency data, end-of-day or historical data for selected international markets; excludes data requiring a higher subscription or separate entitlement. A catalog entry does not prove authorization through this connection. | — |
country | string | No | Country where instrument is traded, e.g., `United States` or `US` Connection coverage: supports US equity data, forex and cryptocurrency data, end-of-day or historical data for selected international markets; excludes data requiring a higher subscription or separate entitlement. A catalog entry does not prove authorization through this connection. | — |
exchange | string | No | Exchange where instrument is traded Connection coverage: supports US equity data, forex and cryptocurrency data, end-of-day or historical data for selected international markets; excludes data requiring a higher subscription or separate entitlement. A catalog entry does not prove authorization through this connection. | — |
interval | enum (1min | 5min | 15min | 30min | 45min | 1h | 2h | 4h | 8h | 1day | 1week | 1month) | No | Interval of the quote. Defaults to 1day when omitted. When eod=true, only 1day is supported; omit eod or set it to false for other intervals. Connection coverage: supports US equity data, forex and cryptocurrency data, end-of-day or historical data for selected international markets; excludes data requiring a higher subscription or separate entitlement. A catalog entry does not prove authorization through this connection. | 1day |
mic_code | string | No | Market Identifier Code (MIC) under ISO 10383 standard Connection coverage: supports US equity data, forex and cryptocurrency data, end-of-day or historical data for selected international markets; excludes data requiring a higher subscription or separate entitlement. A catalog entry does not prove authorization through this connection. | — |
timezone | string | No | Timezone at which output datetime will be displayed. Supports: <ul> <li>1. <code>Exchange</code> for local exchange time</li> <li>2. <code>UTC</code> for datetime at universal UTC standard</li> <li>3. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones" target="blank">here</a>.</li> </ul> <p>Interval Limitation: The timezone parameter is only applicable for intraday intervals (less than 1 day). For intervals of 1day, 1week, or 1month, the timezone parameter is ignored, and data is strictly returned in the Exchange local time.</p> <i>Take note that the IANA Timezone name is case-sensitive</i> | Exchange |
delimiter | string | No | Specify the delimiter used when downloading the CSV file | ; |
rolling_period | integer | No | Number of hours for calculate rolling change at period. By default set to 24, it can be in range [1, 168]. | 24 |
volume_time_period | integer | No | Number of periods for Average Volume | 9 |
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_quote' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"interval": "1day",
"symbol": "TSM"
}
}'Response exampleresponse.json
{
"average_volume": "17702070",
"change": "-25.28000",
"close": "373.45001",
"currency": "USD",
"datetime": "2026-11-16",
"name": "Taiwan Semiconductor Manufacturing Company Ltd. ADR"
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows
Alpha Vantage Alternative for AI Agents: Unified Financial Data via One APILooking for an Alpha Vantage alternative? AgentEarth gives AI agents unified access to stock, forex, crypto and fundamentals data from multiple providers through one MCP connection and one key.What Is MCP? A Practical Guide to Model Context Protocol for AI AgentsMCP (Model Context Protocol) lets AI agents call external tools and data through a standard interface. Learn what MCP is, how it works, and how to connect {{TOOL_COUNT}} tools to Claude Code, Cursor and more.Multi-Asset Portfolio Watch with One AI AgentHoldings spread across A-shares, US stocks, crypto and forex? Use one AI agent to pull quotes from every market, convert to a single currency, and produce one portfolio watch report — no app-hopping.How to Connect AgentEarth to Cursor (MCP Setup, Step by Step)A hands-on guide to connecting AgentEarth to Cursor over MCP. Add the server, paste one config, verify the connection, and call {{TOOL_COUNT}} tools from natural language inside Cursor.The AI Agent Tool Stack for Quant & Investment ResearchWire your whole research workflow into one AI agent — pull A-share and US equity quotes, crypto prices, company fundamentals and market news from a single plain-English prompt instead of juggling separate data subscriptions.Automated Daily Market Briefing with AI AgentsLet an AI agent build your daily market briefing end to end — pull quotes, grab the latest financial news, read today's economic calendar, and assemble it into one briefing on a schedule.

