Twelve Data

Twelve Data Core Data API

Real-time quotes, latest prices, and end-of-day data.

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /eod Get the latest end-of-day closing price · End of day price #
Ask an LLM
“What did this stock close at on the last trading day?”
“Where can I get the official end-of-day close for an instrument?”
Tell an agent
Get the latest end-of-day close for {symbol}.
Fetch yesterday's closing price and metadata for {symbol}.
GET /quote Get a real-time quote with daily stats · Quote #
Ask an LLM
“Can I get open, high, low, volume and the 52-week range for a symbol in one call?”
“How much has this instrument changed in price today?”
Tell an agent
Get a real-time quote for {symbol} at the {interval} interval.
Show the 52-week range and today's change for {symbol} using {interval} bars.
GET /price Get the latest real-time trading price · Real-time price #
Ask an LLM
“What is the current trading price of this ticker right now?”
“Is there a lightweight call that returns only the last price for a symbol?”
Tell an agent
Get the current price of {symbol}.
Tell me what {symbol} is trading at right now, price only.
GET /market_movers/{market} List today's top gainers and losers · Market movers #
Ask an LLM
“Which stocks are the biggest gainers and losers today?”
“What are the top movers by percentage change in the crypto market?”
Tell an agent
Show today's top gainers and losers in the {market} market.
List the biggest percentage movers for {market}.
GET /market_state Check whether exchanges are open or closed · Market state #
Ask an LLM
“Is the stock exchange open right now?”
“Which exchanges are currently closed for trading?”
Tell an agent
Check whether {exchange} is open right now.
Show the open or closed state of every exchange.

Documentation

📖
Documentation
https://twelvedata.com/docs#time-series
📖
Documentation
https://twelvedata.com/docs#core-data
📖
Documentation
https://twelvedata.com/docs#technical-indicators
📖
Documentation
https://twelvedata.com/docs#reference-data
📖
Documentation
https://twelvedata.com/docs#fundamentals

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/openapi/twelvedata-core-data-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/overlays/twelvedata-core-data-api-overlay.yaml
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/collections/twelvedata.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/collections/twelvedata.opencollection.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/twelvedata:twelvedata-core-data-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twelvedata-core-data-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Twelve Data REST Core Data API
  description: REST API for Twelve Data financial market data covering stocks, forex, cryptocurrencies, ETFs, indices, commodities, and funds.
  termsOfService: https://twelvedata.com/terms
  contact:
    name: Twelve Data Support
    url: https://support.twelvedata.com
  version: '1.0'
servers:
- url: https://api.twelvedata.com
  description: Twelve Data REST base URL
security:
- apikeyQuery: []
- apikeyHeader: []
tags:
- name: Core Data
  description: Real-time quotes, latest prices, and end-of-day data.
paths:
  /eod:
    get:
      operationId: getEndOfDay
      tags:
      - Core Data
      summary: End of day price
      description: Returns the latest end-of-day closing price and metadata for an instrument.
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: End-of-day payload.
        '429':
          $ref: '#/components/responses/RateLimited'
  /quote:
    get:
      operationId: getQuote
      tags:
      - Core Data
      summary: Quote
      description: Returns a real-time quote for the instrument including price, open, high, low, close, volume, 52-week range, and change metrics.
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/interval'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Quote payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Quote'
        '429':
          $ref: '#/components/responses/RateLimited'
  /price:
    get:
      operationId: getPrice
      tags:
      - Core Data
      summary: Real-time price
      description: Returns the latest available real-time trading price for an instrument.
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Price payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Price'
        '429':
          $ref: '#/components/responses/RateLimited'
  /market_movers/{market}:
    get:
      operationId: getMarketMovers
      tags:
      - Core Data
      summary: Market movers
      description: Returns the top gainers and losers by percentage change for a market.
      parameters:
      - name: market
        in: path
        required: true
        schema:
          type: string
          enum:
          - stocks
          - etf
          - forex
          - crypto
        description: Market to list movers for.
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Market movers payload.
        '429':
          $ref: '#/components/responses/RateLimited'
  /market_state:
    get:
      operationId: getMarketState
      tags:
      - Core Data
      summary: Market state
      description: Returns the real-time open/closed state of exchanges.
      parameters:
      - name: exchange
        in: query
        schema:
          type: string
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Market state payload.
components:
  schemas:
    Error:
      type: object
      properties:
        code:
          type: integer
          description: HTTP-style status code.
        message:
          type: string
          description: Human-readable error message.
        status:
          type: string
          example: error
    Quote:
      type: object
      properties:
        symbol:
          type: string
        name:
          type: string
        exchange:
          type: string
        currency:
          type: string
        datetime:
          type: string
        open:
          type: string
        high:
          type: string
        low:
          type: string
        close:
          type: string
        volume:
          type: string
        fifty_two_week:
          type: object
          properties:
            low:
              type: string
            high:
              type: string
    Price:
      type: object
      properties:
        price:
          type: string
          example: '201.23'
  parameters:
    symbol:
      name: symbol
      in: query
      required: true
      schema:
        type: string
      description: Instrument symbol, e.g. AAPL, EUR/USD, or BTC/USD.
    apikeyParam:
      name: apikey
      in: query
      required: true
      schema:
        type: string
      description: Your Twelve Data API key.
    interval:
      name: interval
      in: query
      required: true
      schema:
        type: string
        enum:
        - 1min
        - 5min
        - 15min
        - 30min
        - 45min
        - 1h
        - 2h
        - 4h
        - 1day
        - 1week
        - 1month
      description: Time interval between two consecutive data points.
  responses:
    RateLimited:
      description: API credit limit for the current minute has been exceeded.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apikeyQuery:
      type: apiKey
      in: query
      name: apikey
      description: API key supplied as the `apikey` query parameter.
    apikeyHeader:
      type: apiKey
      in: header
      name: Authorization
      description: 'API key supplied as `Authorization: apikey <KEY>`.'