Skip to main content
GET
curl

Authorizations

API-Key
string
header
required

Your public API key. Identifies the partner making the request.

API-Nonce
string
header
required

Monotonically increasing nonce included in the request signature.

API-Sign
string
header
required

HMAC signature over the request, computed with your private key.

Query Parameters

from_symbol
string
required

Source asset ticker symbol (e.g. USD) — the asset the user pays with. Use GET /v1/ramp/fiat-currencies to discover supported source currencies. Ticker symbol of an asset (e.g. BTC, USDC, EUR).

Required string length: 3 - 16
Example:

"BTC"

from_type
enum<string>
default:fiat

Classification of the source asset. Pair with from_symbol to disambiguate when the same ticker exists across asset classes (e.g. USDC as stablecoin vs crypto). Defaults to fiat. Only fiat sources are currently supported (on-ramp).

Available options:
fiat,
crypto,
stablecoin,
xstock
from_method
string
required

Funding method used for the source side. Use GET /v1/ramp/payment-methods to discover supported payment methods.

to_symbol
string
required

Destination asset ticker symbol (e.g. BTC) — the asset the user receives. Use GET /v1/ramp/buy/crypto to discover supported destination assets. Ticker symbol of an asset (e.g. BTC, USDC, EUR).

Required string length: 3 - 16
Example:

"BTC"

to_type
enum<string>
default:crypto

Classification of the destination asset. Pair with to_symbol to disambiguate when the same ticker exists across asset classes (e.g. USDC as stablecoin vs crypto). Defaults to crypto. Only crypto and stablecoin destinations are currently supported (on-ramp).

Available options:
fiat,
crypto,
stablecoin,
xstock
to_method
string
required

Withdrawal method for the destination asset. Use GET /v1/ramp/buy/crypto to discover available withdrawal methods for each asset.

country
string
required

ISO 3166-1 alpha-2 country code. Use GET /v1/ramp/countries to discover supported values.

Maximum string length: 2
subdivision
string

ISO 3166-2 subdivision code suffix (e.g., CA for California when country is US). Use GET /v1/ramp/countries to discover supported values.

Response

Response

data
object
required