Skip to main content
POST
Create an auto-ramp account

Authorizations

Authorization
string
header
required

Cognito JWT token for regular user authentication

Body

Request body for creating a new auto-ramp account. The address format must be valid for the specified network, and the network/token combination must be supported for your region.

Request body for creating a new auto-ramp account. The address format must be valid for the specified network, and the network/token combination must be supported for your region.

address
string
required

Destination wallet address for crypto payouts

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f2a3b8"

network
enum<string>
required
Available options:
ethereum,
polygon,
base,
arbitrum,
avalanche,
optimism,
solana,
tron,
bitcoin
token
string
required

Token to receive (must be valid for network)

Example:

"USDC"

Response

A virtual bank account that automatically converts fiat deposits to crypto. The account is opened in the user's name - funds deposited are converted to the specified token and sent to the destination wallet address. Important: Always confirm the account status is 'active' before initiating a deposit.

A virtual bank account that automatically converts fiat deposits to crypto. The account is opened in the user's name - funds deposited are converted to the specified token and sent to the destination wallet address. Important: Always confirm the account status is 'active' before initiating a deposit.

id
string
required

Unique identifier for this auto-ramp account

Example:

"507f1f77bcf86cd799439011"

depositInstructions
object
required

Deposit instructions for the virtual account. The type field indicates the account format: us for ACH/wire (routing + account number) or iban for SEPA (IBAN + BIC).

network
string
required

Blockchain network where converted crypto will be sent. Lowercase network identifier.

Example:

"ethereum"

address
string
required

Destination wallet address. Fiat deposits are converted and sent to this address.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

token
string
required

Token that fiat deposits will be converted to

Example:

"USDC"

currency
string
required

Fiat currency accepted for deposits

Example:

"USD"

status
enum<string>
required
Available options:
active,
inactive
createdAt
string<date-time>
required

Timestamp when this auto-ramp account was created (ISO 8601)

Example:

"2025-01-15T10:30:00.000Z"