Crypto top-up

List crypto top-ups

Retrieves a paginated list of crypto top-ups with optional filtering by account, address, blockchain network, payment asset code, balance asset code, status, and creation date range.

get/v3/topups/crypto

Request

  • Base URL
    https://confirmo.net/api
  • URL
    https://confirmo.net/api/v3/topups/crypto
  • Auth
    HTTP bearer

Query parameters

status'CONFIRMING' | 'PENDING_VERIFICATION' | 'UNASSIGNED' | 'DONE' | 'BLOCKED' | 'ABSORBED' | 'FAILED' | 'RETURNED'

Filter by status

accountIdstring

Filter by crypto top-up account ID

addressstring

Filter by crypto address

chain'ARC-BLOCKCHAIN-MAINNET' | 'BITCOIN-BLOCKCHAIN-MAINNET' | 'BITCOIN-LIGHTNING-MAINNET' | 'BSC-BLOCKCHAIN-MAINNET' | 'ETHEREUM-ARBITRUM-ONE-MAINNET' | 'ETHEREUM-BLOCKCHAIN-MAINNET' | 'ETHEREUM-OPTIMISM-MAINNET' | 'PLASMA-BLOCKCHAIN-MAINNET' | 'ETHEREUM-POLYGON-MAINNET' | 'LITECOIN-BLOCKCHAIN-MAINNET' | 'SOLANA-BLOCKCHAIN-MAINNET' | 'TRON-BLOCKCHAIN-MAINNET'

Filter by blockchain network

paymentAsset'BNB' | 'BTC' | 'ETH' | 'EURC' | 'LTC' | 'POL' | 'SOL' | 'TRX' | 'USAT' | 'USDC' | 'USDG' | 'USDT' | 'XPL'

Filter by payment crypto asset code

balanceAsset'BNB' | 'BTC' | 'ETH' | 'EURC' | 'LTC' | 'POL' | 'SOL' | 'TRX' | 'USAT' | 'USDC' | 'USDG' | 'USDT' | 'XPL' | 'AED' | 'ALL' | 'AMD' | 'ARS' | 'AUD' | 'AZN' | 'BDT' | 'BGN' | 'BHD' | 'BND' | 'BOB' | 'BRL' | 'BYN' | 'CAD' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DKK' | 'DOP' | 'DZD' | 'EUR' | 'FKP' | 'GBP' | 'GEL' | 'GTQ' | 'HKD' | 'HRK' | 'HUF' | 'CHF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JMD' | 'JPY' | 'KGS' | 'KHR' | 'KWD' | 'KZT' | 'LTL' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MNT' | 'MOP' | 'MUR' | 'MXN' | 'MYR' | 'NGN' | 'NIO' | 'NOK' | 'NZD' | 'PEN' | 'PHP' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'UAH' | 'USD' | 'UYU' | 'VND' | 'XCD'

Filter by balance asset code

createdAtFrominteger

Filter top-ups created after this timestamp (inclusive)

createdAtTointeger

Filter top-ups created before this timestamp (inclusive)

limitinteger

Number of results per page (max 100)

offsetinteger

Pagination offset - number of items to skip

Response

Successfully retrieved paginated list of crypto top-ups.

limitinteger

The number of returned items.

offsetinteger

The number of skipped items.

orderstring

The sort column and the order of returned items.

querystring

The searched string in items.

totalCountinteger

The total number of items owned by the merchant.

Example response

{
  "data": [
    {
      "accountId": "dac1a2b3c4d5e7f8",
      "address": "0xd46faFF817D27c8C10edC580eB573cd4E8fC424d",
      "balanceAsset": "USD",
      "chain": "ETHEREUM_BLOCKCHAIN_MAINNET",
      "id": "dep1a2b3c4d5e7f9",
      "notifyUrl": "https://example.com/crypto-topup/notify",
      "paymentAsset": "ETH",
      "receivedAt": 1772539200,
      "refundDetail": {
        "networkCode": "ETHEREUM-ARBITRUM-ONE-MAINNET"
      },
      "status": "DONE",
      "txHash": "0xc1069c068492e9fa6ea017f226a9c5949781eab340157a14556c5e1017a95070"
    }
  ],
  "limit": 20,
  "order": "createdAt, desc",
  "totalCount": 150
}

Changes

No recorded changes to this operation across all 1 revision of this API.