Create Transfer

Initiate a transfer transaction

POST /api/v1/transfer

Create transfer

cURL

curl --request POST \
  --url https://api.paratro.com/api/v1/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_address": "<string>",
  "to_address": "<string>",
  "chain": "<string>",
  "token_symbol": "<string>",
  "amount": "1.5",
  "memo": "<string>"
}
'

200

Example

{
  "tx_id": "tx_w1x2y3z4a5",
  "status": "PENDING",
  "message": "Transfer initiated successfully."
}

Create Transfer

Create a transfer transaction. Atomically creates a transaction record, locks the transfer amount, and initiates MPC signing.

The system automatically locates the source asset by matching from_address + chain + token_symbol under the authenticated client.

from_address · string · required

Source blockchain address (must belong to the authenticated client, max 255 characters).

to_address · string · required

Destination blockchain address (max 255 characters).

chain · string · required

Enabled chain name for the transfer.

token_symbol · string · required

Token symbol (e.g., USDT, ETH, BTC, max 20 characters).

amount · string · required

Transfer amount in user-facing units (e.g., “1.5” BTC). Must be greater than 0 and must not exceed the asset’s decimal precision.

memo · string

Optional memo or tag (max 100 characters).

Address Validation

The destination address format is validated against the specified chain:

Chain	Format
EVM chains	0x-prefixed 42-character hex
Tron	Base58check-encoded T-prefix
Bitcoin	Valid mainnet/testnet format
Solana	Valid base58 Ed25519 public key

Response

{
  "tx_id": "tx_01HXYZ...",
  "status": "PENDING",
  "message": "Transfer task created"
}

Errors

HTTP	Code	Condition
400	invalid_parameter	Invalid request body, non-positive amount, excessive decimal precision, or identical from_address / to_address
400	insufficient_balance	Insufficient available balance
400	invalid_address	Address format invalid for the chain
400	wallet_not_active	Wallet is not in active state
400	business_error	Transaction amount exceeds wallet limit
404	not_found	No asset found for the given address/chain/token combination
500	internal_error	Internal processing failure

Authorizations

Authorization · string · header · required

JWT access token obtained from the /api/v1/auth/token endpoint.

Body

application/json

from_address · string · required

The sender's blockchain address.

Maximum string length: 255

to_address · string · required

The recipient's blockchain address.

Maximum string length: 255

chain · string · required

Enabled chain name for the transfer.

token_symbol · string · required

The symbol of the token to transfer (e.g., ETH, USDT, BTC).

Maximum string length: 20

amount · string · required

The amount to transfer as a string. Must be greater than 0 and must not exceed the asset's supported decimal precision.

Example:

"1.5"

memo · string

Optional memo or note for the transfer.

Maximum string length: 100

Response

200

application/json

Transfer initiated successfully.

tx_id · string · required

Unique identifier for the created transaction.

Example:

"tx_w1x2y3z4a5"

status · string · required

Initial transfer status returned by the gateway. Currently PENDING when the task is created.

Example:

"PENDING"

message · string · required

A human-readable message about the transfer status.

Example:

"Transfer initiated successfully."