NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Twelve Data

twelve_data

Twelve Data provides a comprehensive financial data API offering real-time and historical market data for stocks, forex, cryptocurrencies, ETFs, and indices.

AnalyticsBusiness IntelligenceWeb del proveedor
Acciones
22
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (22)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

List CommoditiesTWELVE_DATA_COMMODITIES_LISTAcción

Tool to retrieve a list of supported commodities. use when you need all available commodities after obtaining a valid api key.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List CryptocurrenciesTWELVE_DATA_CRYPTOCURRENCIESAcción

Tool to list all supported cryptocurrencies. use when you need the complete set of crypto symbols. use after obtaining a valid api key.

Parámetros de entrada

  • apikeystringObligatorio

    Your Twelve Data API key.

  • symbolstring

    Comma-separated cryptocurrency symbol(s) to filter (e.g., 'BTC,ETH').

  • outputsizeinteger

    Number of records to return, must be >= 1.

Parámetros de salida

  • dataobject[]Obligatorio

    List of supported cryptocurrencies.

  • errorstring

    Error if any occurred during the execution of the action

  • statusstringObligatorio

    Status of the request, 'ok' or 'error'.

  • messagestring

    Error or informational message if applicable.

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Currency ConversionTWELVE_DATA_CURRENCY_CONVERSIONAcción

Tool to convert an amount from one currency to another. use after confirming currency codes to retrieve real-time conversion.

Parámetros de entrada

  • amountnumberObligatorio

    Non-negative amount in the source currency to convert.

  • to_currencystringObligatorio

    Three-letter ISO currency code for the target currency (e.g., 'EUR').

  • from_currencystringObligatorio

    Three-letter ISO currency code for the source currency (e.g., 'USD').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

DividendsTWELVE_DATA_DIVIDENDSAcción

Tool to retrieve dividend payout history for a specified symbol. use when you need historical dividends over multiple years.

Parámetros de entrada

  • formatstringenum

    Response format: 'JSON' or 'CSV'.

    JSONCSV
  • symbolstringObligatorio

    Instrument symbol (e.g., 'AAPL').

  • countrystring

    Country code (e.g., 'United States').

  • end_datestring

    End date in YYYY-MM-DD format.

  • exchangestring

    Exchange code (e.g., 'NASDAQ').

  • timezonestring

    Output timezone for datetime (e.g., 'UTC'). Default is exchange timezone.

  • delimiterstring

    Delimiter for CSV output (only if format='CSV').

  • outputsizeinteger

    Maximum number of dividend records to return (default 30).

  • start_datestring

    Start date in YYYY-MM-DD format.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

EarningsTWELVE_DATA_EARNINGSAcción

Tool to retrieve earnings data including eps estimates and actuals. use when you need detailed earnings history for a selected stock symbol.

Parámetros de entrada

  • typestringenum

    Type of earnings report: 'annual' or 'quarterly'.

    annualquarterly
  • formatstringenum

    Response format: 'JSON' (default) or 'CSV'.

    JSONCSV
  • sourcestring

    Optional data source override.

  • symbolstringObligatorio

    Ticker symbol of the equity, e.g., 'AAPL'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

EPS RevisionsTWELVE_DATA_EPS_REVISIONSAcción

Tool to provide analysts’ revisions of a company’s future eps over the last week and month. use after confirming the stock symbol.

Parámetros de entrada

  • dpinteger

    Number of decimal places for numeric values.

  • formatstringenum

    Response format: 'json' or 'csv'.

    jsoncsv
  • symbolstringObligatorio

    Stock symbol to request data for (e.g., 'AAPL').

  • exchangestring

    Exchange code (e.g., 'NASDAQ'). Auto-detected from symbol if not provided.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

EPS TrendTWELVE_DATA_EPS_TREND_ACTIONAcción

Tool to retrieve historical eps trends for a specified company. use after selecting a stock symbol to view estimated vs actual eps and surprise indicators. returns a breakdown of eps actuals, estimates, differences, and surprise percentages.

Parámetros de entrada

  • formatstringenum

    Output format: 'JSON' or 'CSV'.

    JSONCSV
  • symbolstringObligatorio

    The symbol of the instrument (e.g., 'AAPL').

  • intervalstring

    Data time interval to retrieve EPS trend.

  • timezonestring

    Timezone for response data, e.g., 'UTC' or 'America/New_York'.

  • outputsizeinteger

    Number of results to return, must be at least 1.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

ETFS DirectoryTWELVE_DATA_ETFS_DIRECTORYAcción

Tool to fetch a daily updated list of exchange-traded funds sorted by total assets. use when you need a directory of etfs by exchange or country.

Parámetros de entrada

  • formatstringenum

    Response format: 'JSON' (default) or 'CSV'.

    JSONCSV
  • countrystring

    Filter ETFs by country code (e.g., 'US').

  • exchangestring

    Filter ETFs by exchange code (e.g., 'NASDAQ').

Parámetros de salida

  • dataobject[]Obligatorio

    List of ETF details.

  • errorstring

    Error if any occurred during the execution of the action

  • statusstringObligatorio

    API response status, e.g., 'ok' or 'error'.

  • messagestring

    Error or informational message if applicable.

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

ETFS FamilyTWELVE_DATA_ETFS_FAMILYAcción

Tool to fetch a comprehensive list of etfs by family. use when you need to list etfs managed by a specific investment company.

Parámetros de entrada

  • familystring

    Name of the ETF family to filter by (e.g., 'Vanguard').

Parámetros de salida

  • dataobject[]Obligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get ETF TypesTWELVE_DATA_ETFS_TYPEAcción

Tool to retrieve etf categories by market, including types like 'equity precious metals'. use after confirming api key is set; no parameters are needed.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobject[]Obligatorio

    A list of supported ETF types.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List supported exchangesTWELVE_DATA_EXCHANGESAcción

Tool to retrieve a list of supported exchanges. use when you need all available stock and forex exchanges.

Parámetros de entrada

  • formatstringenum

    Response format; allowed values: json, csv

    jsoncsv
  • countrystring

    Filter exchanges by 2-letter ISO country code, e.g., 'US', 'GB'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List supported forex pairsTWELVE_DATA_FOREX_PAIRSAcción

Tool to retrieve a list of all supported forex currency pairs. use when exploring available forex pairs before making other forex data requests.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List market indicesTWELVE_DATA_INDICESAcción

Tool to retrieve a list of market indices. use when you need to fetch available indices filtered by country.

Parámetros de entrada

  • formatstringenum

    Response format; allowed values: json, csv

    jsoncsv
  • countrystring

    Filter indices by 2-letter ISO country code, e.g., 'US', 'GB'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Mutual Funds FamilyTWELVE_DATA_MUTUAL_FUNDS_FAMILYAcción

Tool to list all available mutual fund families. use when you need a comprehensive list of mutual fund families managed by investment companies after obtaining a valid api key.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobject[]Obligatorio

    List of mutual fund families.

  • errorstring

    Error if any occurred during the execution of the action

  • statusstringObligatorio

    Status of the request, 'ok' or 'error'.

  • messagestring

    Error or informational message if applicable.

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Mutual Funds ListTWELVE_DATA_MUTUAL_FUNDS_LISTAcción

Tool to retrieve a daily updated list of mutual funds sorted by total assets. use when you need to enumerate available mutual funds for analysis.

Parámetros de entrada

  • typestring

    Filter mutual funds by type (e.g., 'Open Ended').

  • formatstringenum

    Output format: 'json' or 'csv'. Default is 'json'.

    jsoncsv
  • countrystring

    Filter mutual funds by country (e.g., 'US').

  • exchangestring

    Filter mutual funds by exchange (e.g., 'NASDAQ').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Options ChainTWELVE_DATA_OPTIONS_CHAIN_ACTIONAcción

Tool to retrieve the options chain for a given symbol and optional expiration date. use when you need detailed option contract data and greeks. omitting date returns all expirations.

Parámetros de entrada

  • datestring

    Expiration date in YYYY-MM-DD format. Omit to retrieve all available expiration dates.

  • symbolstringObligatorio

    Ticker symbol for the option's underlying asset.

  • includeGreeksboolean

    Whether to include Greeks data (delta, gamma, etc.). Default is false.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Options ExpirationTWELVE_DATA_OPTIONS_EXPIRATIONAcción

Tool to retrieve available option expiration dates. use when exploring available expiration dates for a given options symbol.

Parámetros de entrada

  • symbolstringObligatorio

    Ticker symbol of the underlying security for options expiration lookup.

  • exchangestring

    Exchange code where the security is listed.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

QuoteTWELVE_DATA_QUOTEAcción

Tool to retrieve the latest market data for a specified symbol. use when you need a quick real-time quote after selecting a symbol.

Parámetros de entrada

  • formatstringenum

    Response format: 'JSON' or 'CSV'. Default is JSON.

    JSONCSV
  • sourcestring

    Optional data source override, e.g., 'docs'.

  • symbolstringObligatorio

    Ticker symbol to query (e.g., 'AAPL', 'MSFT', 'BTC/USD').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List StocksTWELVE_DATA_STOCKS_LISTAcción

Tool to retrieve a list of stocks. use when you need to fetch securities with optional filtering by exchange, country, type, or symbol.

Parámetros de entrada

  • typestring

    Type of security to filter (e.g., 'Common Stock').

  • formatstringenum

    Response format: 'json' or 'csv'.

    jsoncsv
  • symbolstring

    Specific stock symbol to filter by (e.g., 'AAPL').

  • countrystring

    Country code to filter by (e.g., 'United States').

  • exchangestring

    Exchange code to filter results (e.g., 'NYSE').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Symbol SearchTWELVE_DATA_SYMBOL_SEARCHAcción

Tool to search for financial instruments by symbol or company name. use when you need to discover available symbols before making further data requests.

Parámetros de entrada

  • symbolstringObligatorio

    Symbol or company name to search for, supports partial matches.

  • exchangestring

    Exchange code to filter results (optional).

  • outputsizeinteger

    Maximum number of results to return (1-10000).

Parámetros de salida

  • dataobject[]Obligatorio

    List of matching symbol items.

  • errorstring

    Error if any occurred during the execution of the action

  • statusstringObligatorio

    API response status, e.g., 'ok' or 'error'.

  • messagestring

    Error or info message if applicable.

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Technical IndicatorsTWELVE_DATA_TECHNICAL_INDICATORSAcción

Tool to fetch time-series data for a specific technical indicator. use when you have a symbol, interval, and indicator name.

Parámetros de entrada

  • symbolstringObligatorio

    Symbol to compute the indicator for (e.g., 'AAPL', 'BTC/USD').

  • intervalstringObligatorioenum

    Time interval for the data.

    1min5min15min30min1h2h4h1day1week1month
  • indicatorstringObligatorio

    Name of the technical indicator (e.g., 'sma', 'ema', 'rsi').

  • outputsizeinteger

    Number of data points to return, between 1 and 5000.

  • indicator_paramsobject

    Additional indicator-specific parameters (e.g., period, series_type).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Time SeriesTWELVE_DATA_TIME_SERIESAcción

Tool to retrieve historical and real-time time series data for a specified symbol. use when you need to fetch price data over a time range after selecting a symbol.

Parámetros de entrada

  • formatstringenum

    Response format: 'JSON' or 'CSV'.

    JSONCSV
  • symbolstringObligatorio

    Ticker symbol to query (e.g., 'AAPL').

  • end_datestring

    Inclusive end date for the data, in YYYY-MM-DD or ISO 8601 format.

  • intervalstringObligatorioenum

    Time interval between data points.

    1min5min15min30min1h4h1day1week1month
  • timezonestring

    Timezone for the timestamps, e.g., 'UTC' or 'America/New_York'.

  • outputsizeinteger

    Maximum number of data points to return (default 30, maximum 5000).

  • start_datestring

    Inclusive start date for the data, in YYYY-MM-DD or ISO 8601 format.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not