HOhoruslabsio
Ramp

Get aggregated ramp quotes

Changed on

Returns on-ramp or off-ramp quotes from all eligible providers, sorted by cheapest total cost.

get/ramp/quotes

Request

Query parameters

type'on-ramp' | 'off-ramp' required

Type of quote to get

fiatCurrencystring required
Example:NGN

ISO 4217 fiat currency code

cryptoAmountnumber required
Example:10

Amount of crypto the user wants to receive (on-ramp) or sell (off-ramp). For off-ramp this is the amount of the selected source token.

destinationChain'ARBITRUM_MAINNET' | 'ARBITRUM_TESTNET' | 'AVALANCHE_MAINNET' | 'AVALANCHE_TESTNET' | 'BASE_MAINNET' | 'BASE_TESTNET' | 'STARKNET_MAINNET' | 'STARKNET_TESTNET' | 'BSC_MAINNET' | 'ETHEREUM_MAINNET' | 'ETHEREUM_TESTNET' | 'OPTIMISM_MAINNET' | 'OPTIMISM_TESTNET' | 'MONAD_MAINNET' | 'MONAD_TESTNET' | 'POLYGON_MAINNET' | 'HYPEREVM_MAINNET' | 'LISK_MAINNET' | 'SOLANA_MAINNET' | 'SOLANA_TESTNET' | 'TRON_MAINNET'
Example:BASE_MAINNET

Destination blockchain where user wants funds (required for on-ramp)

sourceChain'ARBITRUM_MAINNET' | 'ARBITRUM_TESTNET' | 'AVALANCHE_MAINNET' | 'AVALANCHE_TESTNET' | 'BASE_MAINNET' | 'BASE_TESTNET' | 'STARKNET_MAINNET' | 'STARKNET_TESTNET' | 'BSC_MAINNET' | 'ETHEREUM_MAINNET' | 'ETHEREUM_TESTNET' | 'OPTIMISM_MAINNET' | 'OPTIMISM_TESTNET' | 'MONAD_MAINNET' | 'MONAD_TESTNET' | 'POLYGON_MAINNET' | 'HYPEREVM_MAINNET' | 'LISK_MAINNET' | 'SOLANA_MAINNET' | 'SOLANA_TESTNET' | 'TRON_MAINNET'
Example:BASE_MAINNET

Source blockchain where user will send crypto from (required for off-ramp)

amountSymbol'USDC' | 'USDT' | 'DAI' | 'BUSD' | 'EURC' | 'ETH' | 'WETH' | 'STRK' | 'BNB' | 'LORDS' | 'USDS' | 'USDG' | 'USDT0' | 'WBTC' | 'LINK' | 'SOL' | 'EKUBO' | 'AAVE' | 'UNI' | 'CURVE' | 'cbBTC' | 'VIRTUAL' | 'stETH' | 'wstETH' | 'SKY' | 'AUSD' | 'WMON' | 'LVMON' | 'OP' | 'WLD' | 'ARB' | 'sAVAX' | 'WAVAX' | 'anyBTC' | 'WBNB' | 'TRON' | 'AVAX' | 'POL' | 'MON'

Token symbol for cryptoAmount (defaults to USDC)

countryCodestring
Example:NG

ISO 3166-1 alpha-2 country code of the user. Required for multi-country currencies (e.g., XOF — pass "BJ" for Benin, "SN" for Senegal). Falls back to the currency's default country if omitted.

directOnlyboolean

If true, only return quotes with direct transfer channels (no widget/redirect)

userEmailstring
Example:user@example.com

User's email. When supplied, recommendation can prefer providers where the user is already KYC-cleared.

Response

Aggregated ramp quotes

Changes

  • 76a4e00b118dRevision changes
    • breaking

      added the new required query request parameter type

    • info

      added the new optional query request parameter amountSymbol

    • info

      added the new optional query request parameter sourceChain

    • info

      added the new optional query request parameter userEmail

    • info

      the query request parameter destinationChain became optional

    • info

      added the new enum value SOLANA_MAINNET to the query request parameter destinationChain

    • info

      added the new enum value SOLANA_TESTNET to the query request parameter destinationChain

    • info

      added the new enum value TRON_MAINNET to the query request parameter destinationChain

  • 654264f49b4dRevision changes
    • info

      endpoint added