Create bank ramp-off

curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-off" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "amount": 0.5,
    "bank_account_id": "ba_xyz789"
  }'

curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-off" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "amount": 25,
    "bank_account_id": "ba_co_abc123",
    "reference": "INV-12345"
  }'

{
  "id": "rampoff_abc123",
  "state": "pending",
  "source_payment_rail": "POLYGON",
  "source_currency": "USDC",
  "destination_payment_rail": "ACH",
  "destination_currency": "USD",
  "amount": 950.00,
  "blockchain_memo": "WITHDRAWAL-REF-123"
}

{
  "code": "VAL",
  "message": "reference must be at most 18 characters"
}

{
  "code": "VAL",
  "message": "reference is required for COP ramp-off"
}

{
  "code": "APP_ERROR",
  "message": "Failed to transfer ramp off of 0.5 of client client_ghi789: Insufficient balance"
}

{
  "code": "APP_ERROR",
  "message": "Failed to transfer ramp off of 0.5 of client client_ghi789: Not enough balance in holding wallet"
}

{
  "code": "NOT_FOUND",
  "message": "Wallet not found"
}

{
  "code": "NOT_FOUND",
  "message": "Bank account ba_xyz789 for company company_xyz789 not found"
}

POST

virtual-wallets

bank-ramps

ramp-off

curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-off" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "amount": 0.5,
    "bank_account_id": "ba_xyz789"
  }'

curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-off" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "amount": 25,
    "bank_account_id": "ba_co_abc123",
    "reference": "INV-12345"
  }'

{
  "id": "rampoff_abc123",
  "state": "pending",
  "source_payment_rail": "POLYGON",
  "source_currency": "USDC",
  "destination_payment_rail": "ACH",
  "destination_currency": "USD",
  "amount": 950.00,
  "blockchain_memo": "WITHDRAWAL-REF-123"
}

{
  "code": "VAL",
  "message": "reference must be at most 18 characters"
}

{
  "code": "VAL",
  "message": "reference is required for COP ramp-off"
}

{
  "code": "APP_ERROR",
  "message": "Failed to transfer ramp off of 0.5 of client client_ghi789: Insufficient balance"
}

{
  "code": "APP_ERROR",
  "message": "Failed to transfer ramp off of 0.5 of client client_ghi789: Not enough balance in holding wallet"
}

{
  "code": "NOT_FOUND",
  "message": "Wallet not found"
}

{
  "code": "NOT_FOUND",
  "message": "Bank account ba_xyz789 for company company_xyz789 not found"
}

Creates and executes a bank ramp-off transaction to withdraw cryptocurrency to a bank account. Requires an API key with access level 2 or higher.

Body

wallet_id

string

required

Virtual wallet identifier.

amount

number

required

Amount in cryptocurrency to convert and withdraw.

bank_account_id

string

required

Bank account identifier for withdrawal.

reference

string

Bank statement reference (concept) for the transfer. Required when the destination bank account currency is COP; ignored otherwise. Maximum 18 characters.

Response

string

Unique ramp-off operation identifier.

state

string

Current state of the operation.

source_payment_rail

string

Source payment rail. One of PIX, WIRE, ACH, SEPA, SPEI, PIX, FASTER_PAYMENTS, CO_BANK_TRANSFER, BRE_B.

source_currency

string

Source cryptocurrency token. One of USDC, USDT.

destination_payment_rail

string

Destination payment rail. One of ACH, WIRE, SEPA, SPEI, PIX, FASTER_PAYMENTS, CO_BANK_TRANSFER, BRE_B.

destination_currency

string

Destination currency. One of USD, EUR, MXN, BRL, GBP, COP.

amount

number

Amount to be withdrawn.

blockchain_memo

string

Blockchain transaction memo or reference.

curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-off" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "amount": 0.5,
    "bank_account_id": "ba_xyz789"
  }'

curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-off" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "amount": 25,
    "bank_account_id": "ba_co_abc123",
    "reference": "INV-12345"
  }'

{
  "id": "rampoff_abc123",
  "state": "pending",
  "source_payment_rail": "POLYGON",
  "source_currency": "USDC",
  "destination_payment_rail": "ACH",
  "destination_currency": "USD",
  "amount": 950.00,
  "blockchain_memo": "WITHDRAWAL-REF-123"
}

{
  "code": "VAL",
  "message": "reference must be at most 18 characters"
}

{
  "code": "VAL",
  "message": "reference is required for COP ramp-off"
}

{
  "code": "APP_ERROR",
  "message": "Failed to transfer ramp off of 0.5 of client client_ghi789: Insufficient balance"
}

{
  "code": "APP_ERROR",
  "message": "Failed to transfer ramp off of 0.5 of client client_ghi789: Not enough balance in holding wallet"
}

{
  "code": "NOT_FOUND",
  "message": "Wallet not found"
}

{
  "code": "NOT_FOUND",
  "message": "Bank account ba_xyz789 for company company_xyz789 not found"
}

Simulate bank ramp-off Get wallet movements

Wallets

Holding

Configuration

Ramps

Transactions

Create bank ramp-off

Body

Response

​Body

​Response

Body

Response