Configuration
List Fiat→Crypto Pairs
Retrieve all supported fiat-to-crypto trading pairs for the on-ramp flow, including the country, fiat symbol, crypto symbol, and trade precision.
GET
/
v2
/
base
/
buy
/
symbols
List Fiat→Crypto Pairs
curl --request GET \
--url https://api-test.velafi.com/v2/base/buy/symbols \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/buy/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/buy/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/buy/symbols")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"country": "<string>",
"fiat": "<string>",
"crypto": "<string>",
"accuracy": 123
}
]
}Use the GET
/v2/base/buy/symbols endpoint to retrieve every fiat-to-crypto trading pair that VelaFi supports for its on-ramp flow. Each pair identifies the source fiat currency (and its country) alongside the target cryptocurrency, plus the decimal precision applied to trade amounts. Use these pairs to populate your UI’s currency selectors and to validate pair eligibility before requesting a quote or submitting an order.
Request
GET /v2/base/buy/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/crypto trading pair objects.
Example
cURL
curl --request GET \
--url 'https://api.velafi.com/v2/base/buy/symbols' \
--header 'X-BH-TOKEN: YOUR_TOKEN'
Response
{
"code": 200,
"msg": "SUCCESS",
"data": [
{
"country": "Mexico",
"fiat": "MXN",
"crypto": "BTC",
"accuracy": 2
},
{
"country": "United States",
"fiat": "USD",
"crypto": "ETH",
"accuracy": 2
}
]
}
Cross-reference this list with the payment methods endpoint (
GET /v2/base/buy/payments) to confirm that a payment method is available for your chosen pair before presenting it to users.Was this page helpful?
⌘I
List Fiat→Crypto Pairs
curl --request GET \
--url https://api-test.velafi.com/v2/base/buy/symbols \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/buy/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/buy/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/buy/symbols")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"country": "<string>",
"fiat": "<string>",
"crypto": "<string>",
"accuracy": 123
}
]
}