Get Basic Rates - Currencycloud API Documentation

Home > Get Basic Rates

/v2/rates/find

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.

Name	In	Type	Description	Value
X-Auth-Token	header	string	Authentication token.
currency_pair	query	string	Concatenated string of the two currencies traded, eg. "USDEUR".
Optional
Name	In	Type	Description	Value
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": [
            "1.407700",
            "1.408300"
        ]
    },
    "unavailable": []
}

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