Crypto Deposit Addresses

Requesting deposit addresses for supported settlement rails and chains.

Request one deposit address for the chain you selected. The API creates or returns the address for your Stabyl account on that route. Addresses are requested on demand, so you do not need to create addresses across every supported chain before the user chooses a route.

curl "https://api-staging.stabyl.com/v1/partner/wallets/crypto/address?chain=tron" \
  -H "X-Api-Key: $STABYL_API_KEY"

Response Handling

Store the chain and address together. When displaying deposit instructions, show the exact chain returned by the API next to the address. If your interface has QR codes, encode only the returned address and keep the chain label visible outside the QR code.

{
  "status": "success",
  "data": {
    "chain": "tron",
    "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "currency": "USD",
    "settlement_rails": ["USDT"]
  }
}

The response fields may include additional route metadata. Preserve unknown fields safely in logs or diagnostics only if your data policy allows it; do not build hard dependencies on fields that are not documented for your workflow.

Safety Rules

• Use the chain value returned by GET /partner/wallets/chains.
• Show the exact returned chain and address.
• Sending funds on a different chain can permanently lose funds.
• In development testing, Tron Nile is the preferred USDT route.
• Do not rewrite, trim, or normalize crypto addresses beyond basic whitespace handling.
• Save the chain alongside every address, deposit record, and support ticket reference.

Crypto deposits credit the USD wallet after confirmation. USDT and USDC are stablecoin rails for USD activity.

Deposit States

State	Meaning
pending	Deposit has been detected or is waiting for confirmation
completed	Deposit has been credited and is available
failed	Deposit could not be credited

Use wallet transaction reads to reconcile the final credited amount and status.

Common failures include unsupported chain values, missing X-Api-Key, or requesting an address before wallet access is enabled.