Wallet History

Returns a unified order history for the specified wallet within the selected time range.

The response contains platform-level order records rather than raw blockchain transactions and follows the standardized Unified Order Object format.

Wallet History

POST https://api-processing.crypto-chief.com/v1/wallets/history

Headers

Name	Value
Content-Type	application/json
Signature	Signed request body
Merchant	Merchant ID

Body

Name	Type	Required	Description
address	string	true	address of the wallet to fetch history for.
date_from	string format: YYYY-MM-DD H:mm:ss	false	Creation date, from
date_to	string format: YYYY-MM-DD H:mm:ss	false	Creation date, to
page	number	false	Page number for pagination
page_size	number	false	Orders per page

Response

200

{
    "items": [
        {
            "type": "PayIn",
            "uuid": "e70e2e2c-94c4-4b7b-8f5e-7f44b9cf9849",
            "order_id": "ord-crypto-1",
            "user_id": "user-1",
            "mode": "crypto",
            "is_test": true,
            "status": "expired",
            "lifetime": 1800,
            "expired_at": "2026-01-13T08:54:33.570117Z",
            "is_expired": true,
            "can_cancel": false,
            "amount_fiat": null,
            "currency": null,
            "amount_crypto": "0.005",
            "fact_amount_fiat": null,
            "fact_amount_crypto": null,
            "accuracy_payment_percent": 5,
            "to_address": "0xc68dc674f17b72cbd1868edf80d91e6828b17477",
            "memo": null,
            "from_address": null,
            "txid": null,
            "coins": [
                {
                    "chain_family": "EVM",
                    "coin": "BNB",
                    "network": "BSC_TESTNET"
                }
            ],
            "has_choices": false,
            "url_success": null,
            "url_error": null,
            "url_callback": null,
            "confirmations": 0,
            "required_confirmations": 20,
            "paid_at": null,
            "confirmed_at": null,
            "additional_data": null,
            "created_at": "2026-01-13T08:24:33.701686Z",
            "payment_link": "https://crypto-terminal.crypto-chief.com/pay/e70e2e2c-94c4-4b7b-8f5e-7f44b9cf9849",
            "payment_coin": "BNB",
            "payment_network": "BSC_TESTNET",
            "convert": {
                "auto_convert": false,
                "coin": "BNB",
                "convert_coin": null,
                "convert_network": null,
                "course_source": "any",
                "network": "BSC_TESTNET",
                "rate": null
            }
        },
        {
            "type": "PayIn",
            "uuid": "c6f5effb-c092-487d-966f-6a3a1010b257",
            "order_id": "test-crypto-2",
            "user_id": "user-1",
            "mode": "fiat",
            "is_test": true,
            "status": "paid",
            "lifetime": 3600,
            "expired_at": "2026-01-09T12:31:09.943182Z",
            "is_expired": false,
            "can_cancel": false,
            "amount_fiat": "0.20",
            "currency": "INR",
            "amount_crypto": "0.0000008166948701840496",
            "fact_amount_fiat": "0.20",
            "fact_amount_crypto": "0.000000820000000000",
            "accuracy_payment_percent": 5,
            "to_address": "0xc68dc674f17b72cbd1868edf80d91e6828b17477",
            "memo": null,
            "from_address": "0xc68dc674f17b72cbd1868edf80d91e6828b17477",
            "txid": "0xc33d079c1abe35f03fb7fcd71878fc877c289f653a33109f373854c67dffc3fe",
            "coins": [
                {
                    "chain_family": "EVM",
                    "coin": "ETH",
                    "network": "ETH_SEPOLIA"
                },
                {
                    "chain_family": "XRP_LEDGER",
                    "coin": "XRP",
                    "network": "XRP_TESTNET"
                },
                {
                    "chain_family": "EVM",
                    "coin": "ETH",
                    "network": "ARBITRUM_SEPOLIA"
                },
                {
                    "chain_family": "EVM",
                    "coin": "MATIC",
                    "network": "POLYGON_AMOY"
                },
                {
                    "chain_family": "SOLANA",
                    "coin": "SOL",
                    "network": "SOLANA_DEVNET"
                },
                {
                    "chain_family": "EVM",
                    "coin": "BNB",
                    "network": "BSC_TESTNET"
                }
            ],
            "has_choices": true,
            "url_success": "https://mysite.com/success",
            "url_error": null,
            "url_callback": "https://mysite.com/callback",
            "confirmations": 32,
            "required_confirmations": 32,
            "paid_at": "2026-01-09T11:50:20.668096Z",
            "confirmed_at": "2026-01-09T11:58:02.153097Z",
            "additional_data": null,
            "created_at": "2026-01-09T11:31:09.943333Z",
            "payment_link": "https://crypto-terminal.crypto-chief.com/pay/c6f5effb-c092-487d-966f-6a3a1010b257",
            "payment_coin": "ETH",
            "payment_network": "ETH_SEPOLIA",
            "convert": {
                "auto_convert": false,
                "coin": "ETH",
                "convert_coin": null,
                "convert_network": null,
                "course_source": "any",
                "network": "ETH_SEPOLIA",
                "rate": "0.0000040834743509"
            }
        },
    ],
    "meta": {
        "page": 1,
        "page_size": 20,
        "total": 2,
        "total_pages": 1
    }
}

400