curl --request POST \
  --url https://api.ripio.com/wallet/transactions/crypto/withdrawal/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "amount": "4.980176",
  "currency": "USDT",
  "address_to": "0x1234567890123456789012345678901234567890",
  "network_fee": "0.01",
  "gateway_data": {
    "network": "plasma"
  }
}
'

{
  "error_code": null,
  "message": null,
  "data": {
    "id": 12346,
    "external_id": null,
    "transaction_type": "withdrawal",
    "rail": "crypto",
    "status": "COM",
    "gateway_details": "bitcoin",
    "transaction_hash": "abc123txhash",
    "from_currency": "BTC",
    "to_currency": "BTC",
    "fiat_currency": "ARS",
    "fee_currency": "BTC",
    "fee": "0.00005",
    "fee_fiat": "5.25",
    "rate": "1",
    "rate_usd": "65000.00",
    "amount_from": "0.001",
    "amount_to": "0.001",
    "amount_fiat": "65.00",
    "amount_usd": "65.00",
    "origin": null,
    "destination": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "tax": null,
    "tax_currency": null,
    "created_at": "2026-04-13T12:00:00Z",
    "updated_at": "2026-04-13T12:01:00Z",
    "extra_data": {}
  },
  "timestamp": 1777674497268
}

{
  "error_code": "ADR_0400",
  "message": "La dirección de destino no es válida. ADR_0400",
  "data": null,
  "timestamp": 1777674872826
}

{
  "error_code": "ERR_0009",
  "message": "Forbidden",
  "data": null
}

{
  "error_code": "BAL_0400",
  "message": "No tenés suficiente saldo disponible para realizar esta operación. BAL_0400",
  "data": null,
  "timestamp": 1777674791342
}

Transactions

Send Crypto To An External Address

Initiates a crypto WITHDRAWAL transaction to an external blockchain address for the authenticated user.

The address_to field must be a valid address for the given currency and network.

Whitelisted contacts only: The destination address must be a previously whitelisted crypto contact of the user. Use POST /contacts/ to create and whitelist a crypto contact before calling this endpoint.

How to obtain the required values:

gateway_data.network: use the GET /currency-networks/ endpoint. Use the code field of the desired network (e.g. "bitcoin", "ethereum", "polygon").
network_fee: use the GET /currency-networks/ endpoint. Use the network_fee field of the chosen network.

Authorization

Requires a valid API key.

POST

wallet

transactions

crypto

withdrawal

curl --request POST \
  --url https://api.ripio.com/wallet/transactions/crypto/withdrawal/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "amount": "4.980176",
  "currency": "USDT",
  "address_to": "0x1234567890123456789012345678901234567890",
  "network_fee": "0.01",
  "gateway_data": {
    "network": "plasma"
  }
}
'

{
  "error_code": null,
  "message": null,
  "data": {
    "id": 12346,
    "external_id": null,
    "transaction_type": "withdrawal",
    "rail": "crypto",
    "status": "COM",
    "gateway_details": "bitcoin",
    "transaction_hash": "abc123txhash",
    "from_currency": "BTC",
    "to_currency": "BTC",
    "fiat_currency": "ARS",
    "fee_currency": "BTC",
    "fee": "0.00005",
    "fee_fiat": "5.25",
    "rate": "1",
    "rate_usd": "65000.00",
    "amount_from": "0.001",
    "amount_to": "0.001",
    "amount_fiat": "65.00",
    "amount_usd": "65.00",
    "origin": null,
    "destination": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "tax": null,
    "tax_currency": null,
    "created_at": "2026-04-13T12:00:00Z",
    "updated_at": "2026-04-13T12:01:00Z",
    "extra_data": {}
  },
  "timestamp": 1777674497268
}

{
  "error_code": "ADR_0400",
  "message": "La dirección de destino no es válida. ADR_0400",
  "data": null,
  "timestamp": 1777674872826
}

{
  "error_code": "ERR_0009",
  "message": "Forbidden",
  "data": null
}

{
  "error_code": "BAL_0400",
  "message": "No tenés suficiente saldo disponible para realizar esta operación. BAL_0400",
  "data": null,
  "timestamp": 1777674791342
}

Headers

authorization

string

required

The API key as a string.

signature

string

required

See the Generating Signature section for more details.

timestamp

number

required

A timestamp in milliseconds. See the Timestamp Security section for more details.

timstamp-tolerance

number

An additional, non-required parameter, that you can send to specify the number of milliseconds after the timestamp for the request to be valid. See the Timestamp Security section for more details.

Body

application/json

amount

string

required

Amount to send as a decimal string.

Example:

"123.32"

currency

string

required

Crypto currency ticker to send.

Example:

"USDT"

address_to

string

required

Destination blockchain address.

Example:

"0x1234567890123456789012345678901234567890"

network_fee

string

required

Network fee as a decimal string. Must be ≥ 0. Obtain the recommended value from the network_fee field in GET /currency-networks/.

Example:

"0.01"

gateway_data

object

required

Gateway-specific data for the crypto send.

Show child attributes

source

string

Optional field to indicate funds come from wallet or ripio trade (default is wallet)

Example:

"trade"

Response

Send transaction created successfully.

error_code

string

required

Example:

null

message

string

required

Example:

null

data

object

required

Transaction object returned by the transactions list, detail and creation endpoints (GET /transactions/, GET /transactions/{id}/, and the 201 responses of every /transactions/{rail}/{action}/ endpoint). All three surfaces share this exact shape.

Show child attributes

Get Transaction Limits Reprocess A Crypto Receive Transaction By Hash

⌘I

Introduction

Ripio Wallet

Ripio Trade

Send Crypto To An External Address

Headers

Body

Response