Forex API

The Forex API provides comprehensive foreign exchange market data including currency pair information and historical exchange rates. This API supports multiple time frame aggregations and is essential for foreign exchange analysis, currency trading strategies, and international portfolio management.

GET/forex/tickers

Retrieves a comprehensive list of all available forex currency pairs. This endpoint supports advanced filtering by country and exchange, providing essential metadata for each currency pair including detailed descriptions and market classifications.

Query Parameters

Parameter	Type	Required	Description
country	string	Optional	Filter tickers by country code (ISO 3166-1 alpha-2). view all values

Examples:

https://api.axionquant.com/forex/tickers

https://api.axionquant.com/forex/tickers?country=US

Response Fields

id number

Unique identifier for the forex pair

ticker string

Currency pair ticker (e.g., "AEDAUD")

detail string

Full description of the currency pair

exchange string

Exchange or data provider code

country string

Country code (ISO 3166-1 alpha-2)

All Forex Tickers

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4tickers = client.forex.tickers(
5    country='AE',
6    exchange='IDC'
7)
8print(tickers)

Response

[
  {
    "id": 2,
    "ticker": "AEDBRX",
    "detail": "U.A.E. DIRHAM / BRAZILIAN REAL REFERENCE RATE",
    "exchange": "IDC",
    "country": "AE"
  },
  {
    "id": 3,
    "ticker": "AEDCAD",
    "detail": "U.A.E. DIRHAM / CANADIAN DOLLAR",
    "exchange": "IDC",
    "country": "AE"
  },
  {
    "id": 4,
    "ticker": "AEDCHF",
    "detail": "U.A.E. DIRHAM / SWISS FRANC",
    "exchange": "IDC",
    "country": "AE"
  },
  {
    "id": 5,
    "ticker": "AEDEUR",
    "detail": "U.A.E. DIRHAM / EURO",
    "exchange": "IDC",
    "country": "AE"
  },
  {
    "id": 7,
    "ticker": "AEDHKD",
    "detail": "U.A.E. DIRHAM / HONG KONG DOLLAR",
    "exchange": "IDC",
    "country": "AE"
  },
  {
    "id": 8,
    "ticker": "AEDINR",
    "detail": "U.A.E. DIRHAM / INDIAN RUPEE",
    "exchange": "IDC",
    "country": "AE"
  }
]

GET/forex/gainers

Retrieves the top gaining forex currency pairs over a specified lookback period. Returns ticker symbols with their percentage change, sorted from highest gainer to lowest. Useful for identifying currency strength and trending pairs.

Query Parameters

Parameter	Type	Required	Description
days	integer	Optional	Lookback period in days (default: 5)
limit	integer	Optional	Maximum number of results to return (default: 10)

Examples:

https://api.axionquant.com/forex/gainers

https://api.axionquant.com/forex/gainers?days=30&limit=20

Response Fields

ticker string

Forex currency pair ticker

pctchange number

Percentage change over the lookback period

Forex Gainers

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4gainers = client.forex.gainers(days=5, limit=10)
5print(gainers)

Response

[
  {
    "ticker": "USDBRL",
    "pctchange": 3.456
  },
  {
    "ticker": "EURUSD",
    "pctchange": 1.234
  },
  {
    "ticker": "GBPUSD",
    "pctchange": 0.987
  }
]

GET/forex/losers

Retrieves the top losing forex currency pairs over a specified lookback period. Returns ticker symbols with their percentage change, sorted from most negative to least negative. Useful for identifying currency weakness.

Query Parameters

Parameter	Type	Required	Description
days	integer	Optional	Lookback period in days (default: 5)
limit	integer	Optional	Maximum number of results to return (default: 10)

Examples:

https://api.axionquant.com/forex/losers

https://api.axionquant.com/forex/losers?days=30&limit=20

Response Fields

ticker string

Forex currency pair ticker

pctchange number

Percentage change over the lookback period

Forex Losers

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4losers = client.forex.losers(days=5, limit=10)
5print(losers)

Response

[
  {
    "ticker": "USDJPY",
    "pctchange": -2.345
  },
  {
    "ticker": "AUDUSD",
    "pctchange": -1.678
  },
  {
    "ticker": "USDCHF",
    "pctchange": -0.987
  }
]

GET/forex/:ticker/quote

Retrieves a comprehensive quote for a specific forex currency pair. Returns the latest OHLC values, exponential moving averages (EMA30, EMA60, EMA90, EMA120), 52-week range statistics, year-to-date performance, and volume data for comprehensive market analysis.

Path Parameters

Parameter	Type	Required	Description
ticker	string	Required	Forex currency pair ticker (e.g., "EURUSD", "GBPJPY")

Examples:

https://api.axionquant.com/forex/EURUSD/quote

https://api.axionquant.com/forex/GBPUSD/quote

Response Fields

latestClose number

Most recent closing price

latestOpen number

Most recent opening price

latestHigh number

Most recent high price

latestLow number

Most recent low price

previousClose number

Previous closing price

week52Range object

52-week high/low range { high: number, low: number }

week52AvgClose number

Average closing price over the trailing 52 weeks

ema30 number

30-period exponential moving average

ema60 number

60-period exponential moving average

ema90 number

90-period exponential moving average

ema120 number

120-period exponential moving average

ytdClosePctChange number

Year-to-date closing price percentage change

volume number

Most recent trading volume

avgVolumeLifetime number

Lifetime average trading volume

Forex Quote

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4quote = client.forex.quote('EURUSD')
5print(quote)

Response

{
  "latestClose": 1.1045,
  "latestOpen": 1.1032,
  "latestHigh": 1.1067,
  "latestLow": 1.1021,
  "previousClose": 1.1032,
  "week52Range": {
    "high": 1.1278,
    "low": 1.0543
  },
  "week52AvgClose": 1.0891,
  "ema30": 1.1056,
  "ema60": 1.0998,
  "ema90": 1.0945,
  "ema120": 1.0912,
  "ytdClosePctChange": 1.234,
  "volume": 0,
  "avgVolumeLifetime": 0
}

GET/forex/:ticker

Retrieves detailed metadata for a specific forex currency pair. This endpoint provides comprehensive information for a single currency pair including its full description, exchange provider, and associated country code.

Path Parameters

Parameter	Type	Required	Description
ticker	string	Required	Forex currency pair ticker symbol (e.g., "AEDAUD", "EURUSD", "GBPJPY")

Examples:

https://api.axionquant.com/forex/EURUSD

https://api.axionquant.com/forex/GBPUSD

Response Fields

id number

Unique identifier for the forex pair

ticker string

Currency pair ticker (e.g., "AEDAUD")

detail string

Full description of the currency pair

exchange string

Exchange or data provider code

country string

Country code (ISO 3166-1 alpha-2)

rating string

Rating classification (e.g., strongsell)

lastClose number

Most recent closing price

changePct number

Percentage change since last close

Ticker Details

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4ticker = client.forex.ticker('AEDAUD')
5print(ticker)

Response

{
  "id": 27,
  "ticker": "AEDUSD",
  "detail": "U.A.E. DIRHAM / U.S. DOLLAR",
  "exchange": "IDC",
  "country": "AE",
  "rating": "strongsell",
  "lastClose": 0.2722718418,
  "changePct": -0.0353971137185937
}

Forex Find Tickers

Forex API

Query Parameters

Examples:

Response Fields

All Forex Tickers

Query Parameters

Examples:

Response Fields

Forex Gainers

Query Parameters

Examples:

Response Fields

Forex Losers

Path Parameters

Examples:

Response Fields

Forex Quote

Path Parameters

Examples:

Response Fields

Ticker Details