INinterlace
Funding

List top-up records

Retrieves top-up records for the API client account, with optional pagination and filtering criteria.

For the request structure, see the Top-Up Search Request Resource. For each item in the paginated response, see the Top-Up Record Resource.

post/open-api/v3/scan2pay/funding/top-ups/search

Request

  • Base URL
    https://api-sandbox.interlace.money
  • URL
    https://api-sandbox.interlace.money/open-api/v3/scan2pay/funding/top-ups/search
  • Auth
    API key in header x-access-token

Request body

pageinteger

Page number

limitinteger

Number of records per page

type'CHARGE' | 'REFUND'

Top-up record type

amountCurrency'USDT' | 'USDC'

Asset symbol

status'SUCCESS' | 'PENDING' | 'FAILED' | 'FREEZE' | 'REFUNDED'

Top-up status

chain'ARB' | 'AVAX' | 'BASE' | 'BNB' | 'ETH' | 'MATIC' | 'OP' | 'TRX' | 'TON' | 'SOL'

Blockchain network

transactionHashstring

Transaction hash

minGmtCreatestring

Numeric string representing the minimum Unix timestamp in milliseconds since epoch

maxGmtCreatestring

Numeric string representing the maximum Unix timestamp in milliseconds since epoch

minGmtModifiedstring

Numeric string representing the minimum last-updated Unix timestamp in milliseconds since epoch

maxGmtModifiedstring

Numeric string representing the maximum last-updated Unix timestamp in milliseconds since epoch

Example request

{
  "page": 1,
  "limit": 10,
  "type": "CHARGE",
  "amountCurrency": "USDT",
  "status": "SUCCESS",
  "chain": "ARB",
  "transactionHash": "0x694d6a05709123c0a123457403b6e190b76b1ecd5a466d320dec65153873df17",
  "minGmtCreate": "1732636500000",
  "maxGmtCreate": "1732636500000",
  "minGmtModified": "1732636500000",
  "maxGmtModified": "1732636500000"
}

Response

Successful operation

codestring

Business code, 000000 means success

messagestring

Message description

Example response

{
  "code": "000000",
  "message": "success",
  "data": {
    "total": "5",
    "list": [
      {
        "id": "1986466477083709441",
        "type": "CHARGE",
        "amountCurrency": "USDT",
        "status": "SUCCESS",
        "chain": "ARB",
        "amount": 98.5,
        "transactionHash": "0x694d6a05709123c0a123457403b6e190b76b1ecd5a466d320dec65153873df17",
        "createTime": "1732636500000",
        "updateTime": "1732636500000"
      }
    ]
  }
}

Changes

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