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/tradingeconomics:tradingeconomics-historical-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

openapi: 3.2.0
info:
  title: Trading Economics Historical API
  description: REST API for Trading Economics economic data covering 196 countries - economic indicators (interest rates, inflation, GDP, unemployment, and 15,000+ other series), the economic calendar, proprietary macro forecasts, full historical time series, live market quotes, and company financials.
  termsOfService: https://tradingeconomics.com/terms-of-service.aspx
  contact:
    name: Trading Economics
    url: https://tradingeconomics.com/contact.aspx
  version: '1.0'
servers:
- url: https://api.tradingeconomics.com
security:
- clientKeyQuery: []
- clientKeyHeader: []
tags:
- name: Historical
paths:
  /historical/country/{countries}/indicator/{indicators}:
    get:
      operationId: getHistoricalByCountryAndIndicator
      tags:
      - Historical
      summary: Historical time series by country and indicator
      description: Returns the historical time series for the given countries and indicators (both comma-separatable). Limited to 10,000 rows per request.
      parameters:
      - name: countries
        in: path
        required: true
        schema:
          type: string
        example: mexico
      - name: indicators
        in: path
        required: true
        schema:
          type: string
        example: gdp
      - $ref: '#/components/parameters/format'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HistoricalValue'
  /historical/country/{countries}/indicator/{indicators}/{startDate}/{endDate}:
    get:
      operationId: getHistoricalByCountryIndicatorAndDates
      tags:
      - Historical
      summary: Historical time series by country, indicator, and date range
      parameters:
      - name: countries
        in: path
        required: true
        schema:
          type: string
        example: mexico,sweden
      - name: indicators
        in: path
        required: true
        schema:
          type: string
        example: gdp,population
      - name: startDate
        in: path
        required: true
        schema:
          type: string
          format: date
        example: '2015-01-01'
      - name: endDate
        in: path
        required: true
        schema:
          type: string
          format: date
        example: '2015-12-31'
      - $ref: '#/components/parameters/format'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HistoricalValue'
  /historical/ticker/{ticker}/{startDate}:
    get:
      operationId: getHistoricalByTicker
      tags:
      - Historical
      summary: Historical time series by ticker from a start date
      parameters:
      - name: ticker
        in: path
        required: true
        schema:
          type: string
        example: usurtot
      - name: startDate
        in: path
        required: true
        schema:
          type: string
          format: date
        example: '2015-03-01'
      - $ref: '#/components/parameters/format'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HistoricalValue'
  /historical/latest:
    get:
      operationId: getHistoricalLatest
      tags:
      - Historical
      summary: Recently released or revised indicator values
      parameters:
      - name: country
        in: query
        required: false
        schema:
          type: string
      - name: date
        in: query
        required: false
        schema:
          type: string
          format: date
      - $ref: '#/components/parameters/format'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HistoricalValue'
  /historical/updates:
    get:
      operationId: getHistoricalUpdates
      tags:
      - Historical
      summary: Recently updated historical records
      parameters:
      - name: d1
        in: query
        required: false
        description: Start date filter (yyyy-mm-dd).
        schema:
          type: string
          format: date
      - name: d2
        in: query
        required: false
        description: End date filter (yyyy-mm-dd).
        schema:
          type: string
          format: date
      - name: lu
        in: query
        required: false
        description: Last-update date filter (yyyy-mm-dd).
        schema:
          type: string
          format: date
      - $ref: '#/components/parameters/format'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HistoricalValue'
components:
  schemas:
    HistoricalValue:
      type: object
      description: One observation in an indicator's historical time series.
      properties:
        Country:
          type: string
        Category:
          type: string
        DateTime:
          type: string
          format: date-time
        Value:
          type: number
        Frequency:
          type: string
        HistoricalDataSymbol:
          type: string
        LastUpdate:
          type: string
          format: date-time
  parameters:
    format:
      name: f
      in: query
      required: false
      description: Output format. JSON is the default for most endpoints.
      schema:
        type: string
        enum:
        - json
        - csv
        - html
  securitySchemes:
    clientKeyQuery:
      type: apiKey
      in: query
      name: c
      description: API client credentials in `key:secret` format passed as the `c` query parameter. Obtain a key by subscribing to a plan at developer.tradingeconomics.com.
    clientKeyHeader:
      type: apiKey
      in: header
      name: Authorization
      description: API client credentials passed in the Authorization header.
externalDocs:
  description: Trading Economics API Documentation
  url: https://docs.tradingeconomics.com