POST
/
transfer
/
paxos
curl --request POST \
  --url https://api.paxos.com/v2/transfer/paxos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ref_id": "idempotence_id",
  "from_profile_id": "b7b77d82-e6a7-4ae9-9904-36231aedf985",
  "to_profile_id": "37867177-f88c-45cc-b9b5-d786e7079609",
  "asset": "BTC",
  "amount": "0.05",
  "metadata": {
    "my_id": "4024ee50-eefb-4f2e-85c7-e7899c0b7da5"
  }
}'
{
  "amount": "0.05",
  "asset": "BTC",
  "auto_conversion": {},
  "balance_asset": "BTC",
  "created_at": "2024-12-11T17:45:14.423911Z",
  "customer_id": "be05ac89-d1dc-4be7-b64a-a003012e9359",
  "direction": "DEBIT",
  "fee": "0",
  "group_id": "b7b6cde7-9053-47e7-bbc0-22d5fa4344ef",
  "id": "fe6bc170-a5be-43ff-bf5b-63c8b6489597",
  "profile_id": "e6b30762-0689-46fa-b208-35eb347e284c",
  "ref_id": "92528c72-4962-4d14-ae4d-6b262df698b2",
  "status": "COMPLETED",
  "total": "0.05",
  "type": "PAXOS_TRANSFER_DEBIT",
  "updated_at": "2024-12-11T17:45:14.479258Z"
}
OAuth Scope
transfer:write_paxos_transfer

Authorizations

​
Authorization
string
header
required

Paxos APIs use OAuth 2 with the client credentials grant flow.

Token URLs:

Learn more in the API credentials guide →

Body

application/json
​
from_profile_id
string
required

The profile from which to send funds.

​
to_profile_id
string
required

The destination profile.

​
amount
string
required

The amount to transfer.

​
asset
string
required

The asset to transfer, e.g. "USD", "BTC", "ETH".

​
ref_id
string

Client-specified ID for replay protection and lookup.

​
metadata
object

Optional client-specified metadata on the sender side of the transaction. Up to 6 key/value pairs may be provided. Each key and value must be less than or equal to 100 characters.

​
recipient_metadata
object

Optional client-specified metadata for the recipient side of the transaction. Up to 6 key/value pairs may be provided. Each key and value must be less than or equal to 100 characters.

​
from_identity_id
string

The Paxos Identity (identity_id) of the sending user.

​
from_account_id
string

The Paxos Account (account_id) of the sending user. Required only for customers with 3rd-Party integrations initiating transfers on behalf of their end users.

​
to_identity_id
string

The Paxos Identity (identity_id) of the destination user.

​
to_account_id
string

The Paxos Account (account_id) of the destination user. Required only for customers with 3rd-Party integrations initiating transfers on behalf of their end users.

Response

A successful response.

​
id
string
required

The Paxos transfer ID.

​
customer_id
string
required

The Paxos customer ID.

​
profile_id
string
required

The target Profile of the transfer. The profile asset balance is debited or credited by the transfer.

​
amount
string
required

The amount sent in the transfer.

​
total
string
required

The balance change from this transfer: amount - fee for deposits, and amount + fee for withdrawals. Unsigned.

​
fee
string
required

The fee paid for the transfer.

​
asset
string
required

The asset for this transfer. This profile's balance of this asset will be debited or credited.

​
direction
enum<string>
required

Direction of the transfer.

Available options:
CREDIT,
DEBIT
​
type
enum<string>
required

Type of transfer.

Available options:
INTERNAL_TRANSFER_DEBIT,
INTERNAL_TRANSFER_CREDIT,
CRYPTO_DEPOSIT,
CRYPTO_WITHDRAWAL,
WIRE_DEPOSIT,
WIRE_WITHDRAWAL,
SEN_DEPOSIT,
SEN_WITHDRAWAL,
BANK_DEPOSIT,
BANK_WITHDRAWAL,
PAXOS_TRANSFER_DEBIT,
PAXOS_TRANSFER_CREDIT,
SIGNET_DEPOSIT,
SIGNET_WITHDRAWAL,
CBIT_WITHDRAWAL,
CBIT_DEPOSIT,
CUBIX_DEPOSIT,
CUBIX_WITHDRAWAL
​
status
enum<string>
required
Available options:
PENDING,
COMPLETED,
FAILED
​
created_at
string<date-time>
required

The time at which this transfer record was created.

​
updated_at
string<date-time>
required

The time at which this transfer record was most recently updated.

​
identity_id
string

The Paxos ID of the Identity associated with the transfer.

​
ref_id
string

The optional client-specified ID for replay protection and lookup.

​
balance_asset
string

The balance_asset represents what asset's balance was affected at Paxos with this transfer. It only differs from Asset when the transfer includes conversion.

​
metadata
object

Optional client-specified stored metadata. For deposit event transfers this metadata is copied from the crypto deposit address or fiat deposit memo used for attribution. Up to 6 key/value pairs may be returned. Each key and value must be less than or equal to 100 characters.

​
destination_address
string

The destination crypto address.

​
crypto_network
enum<string>

A CryptoNetwork is a blockchain transmitting cryptocurrencies.

Available options:
BITCOIN,
ETHEREUM,
BITCOIN_CASH,
LITECOIN,
SOLANA,
POLYGON_POS,
BASE,
ARBITRUM_ONE,
INK
​
crypto_tx_hash
string

For crypto transactions, the on-chain transaction hash.

​
crypto_tx_index
string

For crypto transactions, the output index or output address.

​
account_id
string

The Paxos ID of the Account associated with the transfer.

​
auto_conversion
object
​
group_id
string

Unique identifier linking the debit and credit sides of an internal or Paxos transfer.

​
fiat_account_id
string

For fiat withdrawals, the Paxos ID of the owner's fiat account (UUID).

​
secondary_status
object

Secondary status for the transfer, used for more granular explanation of the transfer status.

​
notional_value
string

For crypto withdrawals and deposits, the USD value of the combined amount and fee at the time of the transfer.

​
memo
string

An optional memo to be included with the transfer as an identifier.

​
status_details
object

Example: { "max_rent_exceeded": { "message": "Transfer cancelled due to suspected system abuse", "destination_address": "7Vbsn3YqXb7kDFvEHCWZRh5osSQXzjYkeFnRhh2Mz5vT" } }

Supported error types:

  • "max_rent_exceeded": Transfer cancelled due to suspected system abuse