Get the rate for a token/amount/fiat combination. This endpoint returns the rate from the first available provider in the priority queue that can handle the specified token, amount, and currency combination.
token
(path, required): The token symbol (e.g., “USDC”, “USDT”)amount
(path, required): The token amount to get the rate forfiat
(path, required): The fiat currency code (e.g., “NGN”, “KES”)network
(query, optional): The blockchain network identifier (e.g., “arbitrum-one”, “polygon”, “base”). If not provided, returns the first matching token across all networks.provider_id
(query, optional): Specific provider ID to get their rate instead of the priority queue selection"Token USDC is not supported"
"Token USDC is not supported on network arbitrum-one"
"Fiat currency XYZ is not supported"
"Invalid amount"
"USDC can only be converted to USD"
"Provider not found"
"Provider does not support this token/currency combination"
"Amount must be between 10 and 1000 for this provider"
"No provider available for USDC to NGN conversion with amount 100"
The API uses the following logic to determine the rate:
provider_id
is provided, returns that provider’s rate (if they support the combination)The current implementation uses a priority queue to determine provider selection:
The priority queue system is the current implementation and may change in future versions. Provider selection is based on priority order, not rate comparison.
Network identifier for the blockchain (optional, filters tokens by network)
base
, bnb-smart-chain
, lisk
, tron
, celo
, arbitrum-one
, polygon
, asset-chain
Provider ID to get the rate for a specific provider. If not provided, returns rate from the public queue.
Token rate
Get the rate for a token/amount/fiat combination. This endpoint returns the rate from the first available provider in the priority queue that can handle the specified token, amount, and currency combination.
token
(path, required): The token symbol (e.g., “USDC”, “USDT”)amount
(path, required): The token amount to get the rate forfiat
(path, required): The fiat currency code (e.g., “NGN”, “KES”)network
(query, optional): The blockchain network identifier (e.g., “arbitrum-one”, “polygon”, “base”). If not provided, returns the first matching token across all networks.provider_id
(query, optional): Specific provider ID to get their rate instead of the priority queue selection"Token USDC is not supported"
"Token USDC is not supported on network arbitrum-one"
"Fiat currency XYZ is not supported"
"Invalid amount"
"USDC can only be converted to USD"
"Provider not found"
"Provider does not support this token/currency combination"
"Amount must be between 10 and 1000 for this provider"
"No provider available for USDC to NGN conversion with amount 100"
The API uses the following logic to determine the rate:
provider_id
is provided, returns that provider’s rate (if they support the combination)The current implementation uses a priority queue to determine provider selection:
The priority queue system is the current implementation and may change in future versions. Provider selection is based on priority order, not rate comparison.
Network identifier for the blockchain (optional, filters tokens by network)
base
, bnb-smart-chain
, lisk
, tron
, celo
, arbitrum-one
, polygon
, asset-chain
Provider ID to get the rate for a specific provider. If not provided, returns rate from the public queue.
Token rate