Managing Deposit Accounts

Retrieve a Single Account

curl https://confirmo.net/api/v3/deposits/crypto/accounts/cda1a2b3c4d5e7f8 \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns the same schema as the create response, including the account status and all current addresses.

List All Accounts

curl "https://confirmo.net/api/v3/deposits/crypto/accounts?limit=20&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "cda1a2b3c4d5e7f8",
      "status": "ENABLED",
      "balanceAsset": "EUR",
      "notifyUrl": "https://your-platform.com/webhooks/deposits",
      "reference": "your_unique_reference",
      "addresses": [ ... ],
      "createdAt": 1772539200,
      "updatedAt": 1772539200
    }
  ],
  "totalCount": 1,
  "limit": 20,
  "offset": 0,
  "order": "createdAt, desc"
}

List & Filter Deposits

Query deposits across all accounts, or filter by account, asset, chain, status, or date. Use this for reconciliation, audit, and building balance-history views.

curl -X GET "https://confirmo.net/api/v3/deposits/crypto?accountId=cda1a2b3c4d5e7f8&status=DONE&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Available query parameters:

Parameter	Type	Description
`accountId`	string	Filter by deposit account ID.
`address`	string	Filter by specific wallet address.
`chain`	string	Filter by blockchain network identifier (e.g. `TRON-BLOCKCHAIN-MAINNET`).
`paymentAsset`	string	Filter by received crypto asset (e.g. `ETH`, `USDT`).
`balanceAsset`	string	Filter by settlement asset.
`status`	string	Filter by deposit status.
`createdAtFrom`	integer	Unix timestamp — deposits created at or after this time.
`createdAtTo`	integer	Unix timestamp — deposits created at or before this time.
`limit`	integer	Results per page. Max 100, default 20.
`offset`	integer	Pagination offset.

Example response 200 OK:

{
  "data": [
    {
      "accountId": "cda1a2b3c4d5e7f8",
      "address": "T9yD14Nj9j7xAB9kf14qMjdZR43bE1Z2L9",
      "chain": "TRON-BLOCKCHAIN-MAINNET",
      "paymentAsset": "USDT",
      "paymentAmount": 250.0,
      "balanceAsset": "EUR",
      "balanceAmount": 231.45,
      "status": "DONE",
      "txHash": "a1b2c3d4e5f6...",
      "receivedAt": 1772539200,
      "notifyUrl": "https://your-platform.com/webhooks/deposits",
      "reference": "your_unique_reference"
    }
  ],
  "totalCount": 1,
  "limit": 20,
  "offset": 0,
  "order": "createdAt, desc"
}

Update an Account

Use PATCH to update the notifyUrl, balanceAsset, reference or status. Omit any field you don't want to change. To clear an optional field, pass null.

curl -X PATCH https://confirmo.net/api/v3/deposits/crypto/accounts/cda1a2b3c4d5e7f8 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "notifyUrl": "https://your-platform.com/webhooks/deposits-v2",
    "status": "DISABLED"
  }'

Field	Values	Notes
`status`	`ENABLED`, `DISABLED`	Disabling stops the account from accepting new deposits. `BLOCKED` can only be set by Confirmo administrators — you cannot block or un-block an account yourself.
`balanceAsset`	Any supported asset code, or `null` to clear.	Clearing removes auto-conversion; received crypto is credited as-is.
`notifyUrl`	URL string, or `null` to clear.	Clearing disables webhook delivery for this account.
`reference`	String, or `null` to clear.