Get indicative foreign exchange rate information for one or more currency pairs in a single request.

This endpoint is intended to provide an indication of the rate available in the market and can support requests for multiple currency pairs, so is good for polling requirements such as live FX ticker widgets. This endpoint should be used where speed, availability and the ability to request multiple currency pairs is important.

The API responses shown below are static. If you want to try out the API please login, or register for an API key

API parameters

X-Auth-Token header string Authentication token.
currency_pair query string Concatenated string of the two currencies traded, eg. "USDEUR". More than one pair can be entered, separated by a comma e.g. "EURGBP,GBPUSD,EURUSD".
on_behalf_of query string A contact UUID for the sub-acccount you're acting on behalf of.
ignore_invalid_pairs query boolean Ignore the validation of currency pairs.
curl -X GET  --header "X-Auth-Token: XXXX-XXXXX-XXXX"  https://devapi.currencycloud.com/v2/rates/find


    "rates": {
        "GBPUSD": [
    "unavailable": []
Error Codes
HTTP Status Code Description Params
400 currency_pair_is_too_long currency_pair can not be longer than 2450 character(s) { "maxlength" => 2450 }
currency_pair_is_too_short currency_pair can not be shorter than 6 letter(s) { "minlength" => 6 }
currency_pair_is_required currency_pair is required
invalid_currency_pair Invalid currency pair { "currency_pair" => ["AAABBB"] }
on_behalf_of_self You cannot act on behalf of your own Contact
contact_not_found Contact was not found for this id
401 invalid_supplied_credentials Authentication failed with the supplied credentials
429 too_many_requests Too many requests have been made to the api. Please refer to the Developer Center for more information
500 internal_server_error Internal server error
503 service_unavailable Service is temporary unavailable
Was this post helpful?
Let us know if you liked the post. That’s the only way we can improve.