Forex Last Quote
You can get the last quote for a symbol with this endpoint.
https://api.finage.co.uk/last/forex/{ symbol }?apikey=YOUR_API_KEY
symbol
= Forex symbol that you want to get prices
https://api.finage.co.uk/last/forex/GBPUSD?apikey=YOUR_API_KEY
With the given example above, you can get the last prices of the GBPUSD.
Response
An example response given below when you make an API request.
Please login to make an API request
{
"symbol":"GBPUSD",
"ask":1.36305,
"bid":1.36292,
"timestamp":1609875979000
}
Forex Last Trade
You can get the last trade price for a symbol with this endpoint.
https://api.finage.co.uk/last/trade/forex/{ symbol }?apikey=YOUR_API_KEY
symbol
= Forex symbol that you want to get the last trade price
https://api.finage.co.uk/last/trade/forex/GBPUSD?apikey=YOUR_API_KEY
With the given example above, you can get the last trade price of the GBPUSD.
Response
An example response given below when you make an API request.
Please login to make an API request
{
"symbol": "GBPUSD",
"price": 1.37,
"timestamp": 1618001940
}
Historical Forex Tick Data
You can get the last quote for a symbol with this endpoint.
https://api.finage.co.uk/history/ticks/forex/{ symbol }/{ date }?limit={ limit }&apiKey=YOUR_API_KEY
symbol
= Forex symbol that you want to get prices
date
= Date for the tick data. [YYYY-MM-dd]
apikey
= Your API key
limit
= Tick limit. Default is 10. Maximum allowed limit is 5000.
tso
= Timestamp offset for pagination.
https://api.finage.co.uk/history/ticks/forex/gbpusd/2021-01-04?limit=50&tso=1609718400000&apiKey=YOUR_API_KEY
With the given example above, you can get the ticks of the GBPUSD.
Response
An example response given below when you make an API request.
Please login to make an API request
{
"symbol":"GBPUSD",
"date":"2021-01-04",
"ticks":[
{
"b":1.36805,
"a":1.3682,
"t":1609718400000
},
...
]
}
symbol
= Forex symbol
date
= Date of the ticks
- a= Ask price
- b = Bid price
t
= Timestamp [ms].
Forex Aggregates
With the Forex Aggregates API, you can get the tick bars of the forex symbol.
https://api.finage.co.uk/agg/forex/{ symbol }/{ multiply }/{ time }/{ from }/{ to }?apikey=YOUR_API_KEY
symbol
= Forex symbol
multiply
= Time multiplier
time
= Size of the time. [minute, hour, day, week, month, quarter, year]
- from = Start date
- to = End date
apikey
= Your API key
limit
= Limit of the results. Default is 100, maximum allowed limit is 50000. Please set a limit if you are using the API in the production.
sort
= You can sort the results by timestamp. asc will return ascending results oldest to newest, desc will return descending results newest to oldest. Default is asc.
dbt_filter
= Daily-based time filter. You can allow the time filters to filter daily based. Otherwise, the filter will only trim the start and end of the output. Default is false.
- st = Start time in UTC. (Eg. 17:30)
et
= End time in UTC. (Eg. 17:45)
https://api.finage.co.uk/agg/forex/GBPUSD/1/day/2021-01-01/2021-01-05?apikey=YOUR_API_KEY&st=10:00&et=13:30
You can get the tick bars of the GBPUSD with the given example above.
Response
Please login to make an API request
{
"symbol":"GBPUSD",
"totalResults":4,
"results":[
{
"v":254,
"o":1.3642,
"c":1.3667,
"h":1.3677,
"l":1.3642,
"t":1609477200000
},
...
]}
- Parameters
symbol
= Forex symbol
totalResults
= Total result size
o
= Open price
h
= High price
l
= Low price
c
= Close price
v
= Volume
t
= Timestamp [ms]
Forex Previous Close
With the Forex Previous Close API, you can get the previous day's last tick bar of the forex market.
https://api.finage.co.uk/agg/forex/prev-close/{ symbol }?apikey=YOUR_API_KEY
symbol
= Symbol of the forex
unadjusted
= Unadjust the prices. Default is true.
https://api.finage.co.uk/agg/forex/prev-close/GBPUSD?apikey=YOUR_API_KEY
You can get the previous day's last tick bar of the GBPUSD with the given example above.
Response
Please login to make an API request
{
"symbol": "GBPUSD",
"totalResults": 1,
"results": [
{
"o": 1.40456,
"h": 1.41105,
"l": 1.4034,
"c": 1.40948,
"v": 103566,
"t": 1621036799999
}
]
}
- Parameters
symbol
= Symbol of the forex
totalResults
= Total result size
o
= Open price
h
= High price
l
= Low price
c
= Close price
v
= Volume
t
= Timestamp [ms]
Forex Currency Converter API
With this endpoint, you can convert the currencies with the real-time prices.
https://api.finage.co.uk/convert/forex/{ from }/{ to }/{ amount }?apikey=YOUR_API_KEY
- from = "From" symbol of the currency.
- to = "To" symbol of the currency.
amount
= The amount to convert.
https://api.finage.co.uk/convert/forex/GBP/USD/3?apikey=YOUR_API_KEY
With the given example above, you can get the converted price value.
Response
An example response given below when you make an API request.
Please login to make an API request
{
"from": "GBP",
"to": "USD",
"amount": 3,
"value": 4.2285,
"timestamp": 1621027210000
}