Developers

Sandbox

Add funds to an account (sandbox only)

POST/sandbox/accounts/{accountId}/deposits

Sandbox only. In production this path does not exist and answers 404.

Credits one of your fiat accounts as a bank transfer arriving on it does, through the same path a real deposit takes: the account's transactions show a deposit, and its balance rises by the amount less the deposit fee your pricing sets, if any. There is no deposit event, so no webhook is sent.

amount.currency must be the account's currency, or the request is currency_mismatch. A crypto account cannot be funded this way: unsupported_currency.

Always 202 with the account as it stands; the credit follows asynchronously. Read GET /accounts/{accountId}/transactions?type=deposit, or the account's balance. An account that cannot take the credit — one that is not active — is not credited, and nothing reports it. Requires sandbox:write.

Authentication
ApiKeyAuth
Execution
asynchronous

Parameters

  • accountIdstringpathrequired
    Opaque account identifier. Treat as a string; never parse or construct it.

    Example: acc_AAAAAAAAAAc

    pattern ^acc_[A-Za-z0-9_-]{11}$

  • Idempotency-Keystringheaderrequired
    Client-generated unique key for this logical request (UUID recommended). See Idempotency.

    min length 1 · max length 255

  • X-Request-Idstringheader
    Optional client correlation id; echoed back unchanged.

    max length 128

Request body application/jsonrequired

  • amountMoneyrequired
    What arrives, in the account's currency.
    • valuestringrequired

      Example: 149.90

      pattern ^-?\d{1,18}(\.\d{1,18})?$

    • currencystringrequired
      ISO 4217 code for fiat (EUR), asset ticker for crypto (USDT).

      Example: EUR

      pattern ^[A-Z0-9]{3,10}$

Responses

The account as it stands. The credit follows asynchronously.

Headers

  • Locationstring (uri-reference)
    The resource URL to poll for the current state (RFC 9110 §15.3.3 status monitor).
  • X-Request-Idstring
    The client's X-Request-Id if supplied, otherwise a server-generated id. Equals traceId in problems.
  • RateLimit-Limitinteger
  • RateLimit-Remaininginteger
  • RateLimit-Resetinteger
    Seconds until the window resets.
  • Idempotent-Replayedboolean
    true when this response was replayed from an earlier request with the same Idempotency-Key.

Schema application/json

  • objectstringrequired

    Allowed values: account

  • idstringrequired
    Opaque account identifier. Treat as a string; never parse or construct it.

    Example: acc_AAAAAAAAAAc

    pattern ^acc_[A-Za-z0-9_-]{11}$

  • namestringrequired
    Display name set in the portal.
  • currencystringrequired
    ISO 4217 code for fiat (EUR), asset ticker for crypto (USDT).

    Example: EUR

    pattern ^[A-Z0-9]{3,10}$

  • typestringrequired

    Allowed values: fiatcrypto

  • statusstringrequired
    pending awaiting activation · active · frozen (also covers restricted) · closed (also closing).

    Allowed values: pendingactivefrozenclosed

  • balanceobject
    Ledger balance including holds. null when the balance could not be read at this moment.
    • valuestringrequired

      Example: 149.90

      pattern ^-?\d{1,18}(\.\d{1,18})?$

    • currencystringrequired
      ISO 4217 code for fiat (EUR), asset ticker for crypto (USDT).

      Example: EUR

      pattern ^[A-Z0-9]{3,10}$

  • availableBalanceobject
    What you can spend now. null when the balance could not be read at this moment.
    • valuestringrequired

      Example: 149.90

      pattern ^-?\d{1,18}(\.\d{1,18})?$

    • currencystringrequired
      ISO 4217 code for fiat (EUR), asset ticker for crypto (USDT).

      Example: EUR

      pattern ^[A-Z0-9]{3,10}$

  • ibanstring
    Present for fiat accounts with a dedicated IBAN.
  • bicstring
    Present together with iban.
  • networksarray<object>
    Crypto accounts only — the active networks the asset can be paid out on. Send network (or networkCode) as destination.network of a crypto_wallet payout.
    • networkstringrequired
      Chain code.

      Example: TRX

    • namestringrequired

      Example: Tron

    • networkCodestringrequired
      Token standard.

      Example: TRC20

  • isDefaultbooleanrequired
    Your default account in this currency: the one debited when a payout, transfer or exchange leaves its account id out. At most one per currency.
  • createdAtstring (date-time)required
    RFC 3339, UTC, with millisecond precision.

    Example: 2026-09-18T10:15:30.123Z

  • updatedAtstring (date-time)required
    Currently the creation time (account modifications are not tracked yet).

    Example: 2026-09-18T10:15:30.123Z