Get basic foreign exchange rate information for multiple currency pairs.

You can try this API by supplying the required parameters and running the code. It'll return a live response from the API.

API parameters

X-Auth-Token header string Authentication token.
currency_pair query string Concatenated string of the two currencies traded, eg. "USDEUR".
on_behalf_of query string Contact UUID.
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_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.