Currencies

Exchange rate

The exchange rate endpoint provides real-time exchange rates for specified currency pairs, including both forex and cryptocurrency. It returns the current exchange rate value between two currencies, allowing users to quickly access up-to-date conversion rates for financial transactions or market analysis.

Route

/exchange_rate

API credits cost

1 per symbol

Parameters Response

✱ symbol

string

The currency pair you want to request can be either forex or cryptocurrency. Slash(/) delimiter is used. E.g. EUR/USD or BTC/ETH will be correct

Example: EUR/USD

date

string

If not null, will use exchange rate from a specific date or time. Format 2006-01-02 or 2006-01-02T15:04:05. Is set in the local exchange time zone, use timezone parameter to specify a specific time zone

Example: 2006-01-02T15:04:05

format

string

Value can be JSON or CSV. Default JSON

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file. Default semicolon ;

Default: ;

integer

The number of decimal places for the data

Default: 5

timezone

string

Timezone at which output datetime will be displayed. Supports:

1. Exchange for local exchange time
2. UTC for datetime at universal UTC standard
3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Take note that the IANA Timezone name is case-sensitive

Example: UTC

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/exchange_rate?symbol=EUR/USD&apikey=demo

Response

{
    "symbol": "USD/JPY",
    "rate": 105.12,
    "timestamp": 1602714051
}

Currency conversion Useful

The currency conversion endpoint provides real-time exchange rates and calculates the converted amount for specified currency pairs, including both forex and cryptocurrencies. This endpoint is useful for obtaining up-to-date conversion values between two currencies, facilitating tasks such as financial reporting, e-commerce transactions, and travel budgeting.

Route

/currency_conversion

API credits cost

1 per symbol

Parameters Response

✱ symbol

string

The currency pair you want to request can be either forex or cryptocurrency. Slash(/) delimiter is used. E.g. EUR/USD or BTC/ETH will be correct

Example: EUR/USD

✱ amount

double

Amount of base currency to be converted into quote currency. Supports values in the range from 0 and above

Example: 100

date

string

Example: 2006-01-02T15:04:05

format

string

Value can be JSON or CSV. Default JSON

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file. Default semicolon ;

Default: ;

integer

The number of decimal places for the data

Default: 5

timezone

string

Timezone at which output datetime will be displayed. Supports:

1. Exchange for local exchange time
2. UTC for datetime at universal UTC standard
3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Take note that the IANA Timezone name is case-sensitive

Example: UTC

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/currency_conversion?symbol=EUR/USD&amount=100&apikey=demo

Response

{
    "symbol": "USD/JPY",
    "rate": 105.12,
    "amount": 12824.64,
    "timestamp": 1602714051
}