v1

latestOpenAPI 3.1.02026-07-241653251.3 MB
Fund

Create deposit

This endpoint is used to create a new Fiat deposit and enable instant buying power.

post/fund/deposit

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required
Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Request body

participant_codestring required

The participant code tied to the deposit

external_account_idstring required

The external account id tied to the deposit

asset'USD' required

The asset code for the deposit, e.g. USD

amountstring required

The amount of the deposit

descriptionstring required

Description of the deposit

network'ach' required

The network for the deposit, e.g. ach.

instantboolean required

Whether the deposit should be processed instantly

Example request

{
  "participant_code": "ABCDEF",
  "external_account_id": "0f34533e-2114-469d-b505-c850d776e061",
  "asset": "USD",
  "amount": "100",
  "description": "Deposit for trading account",
  "network": "ach",
  "instant": true
}

Response

Successfully created the fiat deposit. Returns the submitted transaction details including its current status.

request_idstring uuid

The request id associated with this deposit submission. Echoes the X-Request-Id header when supplied by the client.

transaction_idstring uuid

zerohash-generated unique identifier for the deposit.

external_account_idstring

The external (bank) account identifier debited for this deposit.

trade_idstring

Associated trade identifier. Empty string when no conversion trade was created (e.g. USD deposits).

descriptionstring

Description of the deposit as supplied on the request.

amountstring

The amount of the deposit.

status'posted' | 'cancelled' | 'failed' | 'returned' | 'submitted' | 'pending' | 'settled' | 'rejected' | 'returned_settled' | 'retried' | 'unspecified'

Current status of the deposit.

transfer_type'debit' | 'credit'

Fiat transfer direction for this transaction.

network'ach'

The network used to process the deposit.

participant_codestring

The participant code credited by this deposit.

account_labelstring

The account label credited by this deposit. Always 'general' for fund deposits.

currency'USD'

The fiat currency of the deposit.

created_atstring date-time

ISO-8601 timestamp indicating when the deposit was created.

Example response

{
  "request_id": "d39b1957-d0cc-40d7-9daf-9a31e9584c5f",
  "transaction_id": "bfa45e86-d414-4dda-863a-42bbdd7f389e",
  "external_account_id": "487e49ac-c797-4136-8675-9464fc5e8a12",
  "description": "Deposit for trading account",
  "amount": "5000",
  "status": "submitted",
  "transfer_type": "debit",
  "network": "ach",
  "participant_code": "ABCDEF",
  "account_label": "general",
  "currency": "USD",
  "created_at": "2026-05-04T11:58:45.221Z",
  "ach_agreement_acceptance": {
    "timestamp": 1708631671631,
    "version": "1.0.0"
  }
}