Configuration
List Fiat→Fiat Pairs
Retrieve all supported fiat-to-fiat global payment pairs, including originating and recipient country, fiat symbols, and decimal trade precision.
GET
/
v2
/
base
/
fiat
/
symbols
List Fiat→Fiat Pairs
curl --request GET \
--url https://api-test.velafi.com/v2/base/fiat/symbols \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/fiat/symbols"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/base/fiat/symbols', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/base/fiat/symbols")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"onRampCountry": "<string>",
"onRampFiat": "<string>",
"offRampCountry": "<string>",
"offRampFiat": "<string>",
"accuracy": 123
}
]
}Use the GET
/v2/base/fiat/symbols endpoint to retrieve every fiat-to-fiat currency pair that VelaFi supports for global payments over stablecoin rails. Each pair defines the originating (on-ramp) country and currency alongside the recipient (off-ramp) country and currency. Use this list to populate your currency corridor selector and validate pair eligibility before requesting a quote or creating a payment.
Request
GET /v2/base/fiat/symbols
Headers
| Header | Value | Required |
|---|---|---|
X-BH-TOKEN | Your token from GET /v2/token/generate | ✓ |
Query Parameters
This endpoint takes no query parameters.Response Fields
number
HTTP-style status code.
200 indicates success.string
Human-readable status message, e.g.
"SUCCESS".array
Array of fiat/fiat trading pair objects.
Show data[]
Show data[]
string
Name of the originating country (e.g.,
"Mexico").string
ISO 4217 code for the originating fiat currency (e.g.,
"MXN").string
Name of the recipient country (e.g.,
"Argentina").string
ISO 4217 code for the recipient fiat currency (e.g.,
"ARS").number
Number of decimal places used for trade amounts in this pair.
Example
cURL
curl --request GET \
--url 'https://api.velafi.com/v2/base/fiat/symbols' \
--header 'X-BH-TOKEN: YOUR_TOKEN'
Response
{
"code": 200,
"msg": "SUCCESS",
"data": [
{
"onRampCountry": "Mexico",
"onRampFiat": "MXN",
"offRampCountry": "Argentina",
"offRampFiat": "ARS",
"accuracy": 2
},
{
"onRampCountry": "United States",
"onRampFiat": "USD",
"offRampCountry": "Mexico",
"offRampFiat": "MXN",
"accuracy": 2
}
]
}
Pairs are directional.
MXN → ARS and ARS → MXN are listed as separate entries. Always verify that the exact corridor you need appears in the response before proceeding.Was this page helpful?
⌘I
List Fiat→Fiat Pairs
curl --request GET \
--url https://api-test.velafi.com/v2/base/fiat/symbols \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/fiat/symbols"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/base/fiat/symbols', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/base/fiat/symbols")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"onRampCountry": "<string>",
"onRampFiat": "<string>",
"offRampCountry": "<string>",
"offRampFiat": "<string>",
"accuracy": 123
}
]
}