Page Query Merchant Addresses

POST

/api/v1/merchants/addresses/pageQuery

Paginated query for crypto deposit addresses by merchant IDs. Supports filtering by network code and asset code. Tenant isolation is enforced: only addresses belonging to merchants under the current tenant are returned.

Request

Authorization

API Key

Add parameter in header

x-signature

Example:

x-signature: ********************

Header Params

Body Params application/json

Examples

Query USDT addresses for two merchantsQuery all addresses for a merchant

{
    "page": 1,
    "size": 20,
    "merchantIds": [
        "M001",
        "M002"
    ],
    "networkCodes": [
        "ERC-20"
    ],
    "assetCodes": [
        "USDT"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Query USDT addresses for two merchantsQuery all addresses for a merchant

curl --location '/api/v1/merchants/addresses/pageQuery' \
--header 'x-app-id;' \
--header 'x-timestamp: 0' \
--header 'x-nonce;' \
--header 'x-request-id;' \
--header 'x-lang;' \
--header 'x-signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "page": 1,
    "size": 20,
    "merchantIds": [
        "M001",
        "M002"
    ],
    "networkCodes": [
        "ERC-20"
    ],
    "assetCodes": [
        "USDT"
    ]
}'

Responses

🟢200

application/json

Addresses retrieved successfully

Bodyapplication/json

Example

{
    "success": true,
    "requestId": "string",
    "timestamp": "2019-08-24T14:15:22.123Z",
    "data": {
        "pagination": {
            "page": 1,
            "size": 1,
            "total": 0,
            "totalPages": 0
        },
        "items": [
            {
                "merchantId": "string",
                "networkCode": "string",
                "assetCode": "string",
                "status": "ACTIVE",
                "address": "string",
                "createdAt": "2026-04-01 10:30:00"
            }
        ]
    }
}

🟠400

🟠401

🟠403

🟠429

Modified at 2026-04-11 03:51:18

Query Account List

Query Collection Instruments