List Addresses

GET /api/v2/analytics/chains/{chain}/addresses

Retrieve the paginated list of address based on the requesting business identity.

Path Parameters

Name	Type	Description	Required
chain	string	Blockchain network name. Example: bitcoin	True

Query Parameters

Name	Type	Description	Required
start_range	string	Starting point for specified data range. Example: 2020-12-09
end_range	string	Ending point for specified data range. Example: 2023-12-09
page	integer	The current page number in pagination. Minimum: 1, Default: 1
size	integer	The size or number of records per page. Minimum: 1, Maximum: 50, Default: 10
sort	string	Criteria for result sorting. Example: -created

Sample Request

REQUEST

curl -X POST https://sandbox.ospree.io/api/v2/analytics/chains/all/addresses?start_range=2024-01-01&end_range=2025-04-15&page=1&size=10&sort=-created

-h 'Content-Type: application/json' \
-h 'Accept: application/json' \
-h 'Authorization: ••••••' \

RESPONSE

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "0195fd99-5872-75c8-bee2-69a36b4434a1",
                "address": "0x97e813B9a81d097e60a5E6311bc9A475199B67aE",
                "chain": "ethereum",
                "dti": "X9J9K872S",
                "is_self_hosted": true,
                "risk_ratio": 39,
                "balance_usd": 13963912.447702782,
                "balance": 7753.421681123144,
                "symbol": "ETH",
                "last_modified": "2025-04-03T21:40:41.049947+00:00",
                "created": "2025-04-03T21:40:40.031448+00:00"
            },
            {
                "id": "0196288f-0271-7747-a935-b82ed8165ec0",
                "address": "1Q8QR5k32hexiMQnRgkJ6fmmjn5fMWhdv9",
                "chain": "bitcoin",
                "dti": "4H95J0R2X",
                "is_self_hosted": false,
                "risk_ratio": 39,
                "balance_usd": 850890689.7822123,
                "balance": 10216.72063792,
                "symbol": "BTC",
                "last_modified": "2025-04-12T05:53:03.073340+00:00",
                "created": "2025-04-12T05:53:03.073335+00:00"
            },
            {
                "id": "01963491-4765-717d-bcfb-e9ff5ed380a7",
                "address": "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy",
                "chain": "bitcoin",
                "dti": "4H95J0R2X",
                "is_self_hosted": false,
                "risk_ratio": null,
                "balance_usd": 0.0,
                "balance": 0.0,
                "symbol": "BTC",
                "last_modified": "2025-04-15T09:36:47.935292+00:00",
                "created": "2025-04-14T13:50:58.395551+00:00"
            },
            {
                "id": "0195fd9a-e5ec-7e91-88c5-a5fde482a7a1",
                "address": "0x4a43481ead96C0B1077c0faEAA664D8fdd4b5f7f",
                "chain": "ethereum",
                "dti": "X9J9K872S",
                "is_self_hosted": true,
                "risk_ratio": 49,
                "balance_usd": 0.028839256849896265,
                "balance": 1.6024658189176e-05,
                "symbol": "ETH",
                "last_modified": "2025-04-03T21:42:22.014785+00:00",
                "created": "2025-04-03T21:42:21.927197+00:00"
            },
            {
                "id": "0195ff1c-45f5-7aec-93f0-4c38f11961c3",
                "address": "bc1qm6ysn7d6ar667m2gpesw4ks0xg768pg6487c8m",
                "chain": "bitcoin",
                "dti": "4H95J0R2X",
                "is_self_hosted": true,
                "risk_ratio": null,
                "balance_usd": 34.168112962500004,
                "balance": 0.00041255,
                "symbol": "BTC",
                "last_modified": "2025-04-04T04:43:17.872876+00:00",
                "created": "2025-04-04T04:43:17.872872+00:00"
            },
            {
                "id": "0195c6d0-0ece-7e28-be73-bf811da978dd",
                "address": "0x95222290DD7278Aa3Ddd389Cc1E1d165CC4BAfe5",
                "chain": "ethereum",
                "dti": "X9J9K872S",
                "is_self_hosted": true,
                "risk_ratio": 0,
                "balance_usd": 19783.101803049667,
                "balance": 10.966242684617333,
                "symbol": "ETH",
                "last_modified": "2025-04-04T14:01:13.059796+00:00",
                "created": "2025-03-24T06:21:18.923350+00:00"
            },
            {
                "id": "0196288f-9f37-785c-a5eb-216f78573c0b",
                "address": "bc1qfn9ljy4g7kdpl4stlyys030wpstcep03w9rvx2",
                "chain": "bitcoin",
                "dti": "4H95J0R2X",
                "is_self_hosted": true,
                "risk_ratio": 50,
                "balance_usd": 866805835.6938196,
                "balance": 10407.42033621,
                "symbol": "BTC",
                "last_modified": "2025-04-12T05:53:43.208307+00:00",
                "created": "2025-04-12T05:53:43.208304+00:00"
            },
            {
                "id": "0196385b-be20-7809-9148-8c3cc17a5cd2",
                "address": "3K1hqWvwo2pPeQEE9obTbWzoLJAP52JJuF",
                "chain": "bitcoin",
                "dti": "4H95J0R2X",
                "is_self_hosted": true,
                "risk_ratio": 0,
                "balance_usd": 0.0,
                "balance": 0.0,
                "symbol": "BTC",
                "last_modified": "2025-04-15T07:38:57.263278+00:00",
                "created": "2025-04-15T07:30:58.563649+00:00"
            },
            {
                "id": "019638ce-3ed1-7c01-85c9-2c7918f6c506",
                "address": "1BoatSLRHtKNngkdXEeobR76b53LETtpyT",
                "chain": "bitcoin",
                "dti": "4H95J0R2X",
                "is_self_hosted": false,
                "risk_ratio": null,
                "balance_usd": 0.0,
                "balance": 0.0,
                "symbol": "BTC",
                "last_modified": "2025-04-15T09:35:59.962786+00:00",
                "created": "2025-04-15T09:36:02.759292+00:00"
            },
            {
                "id": "0196011b-9c2a-7c63-9a3d-3aa45d3c6fbc",
                "address": "0x388C818CA8B9251b393131C08a736A67ccB19297",
                "chain": "ethereum",
                "dti": "X9J9K872S",
                "is_self_hosted": true,
                "risk_ratio": 39,
                "balance_usd": 33392.04656315908,
                "balance": 18.6795067005807,
                "symbol": "ETH",
                "last_modified": "2025-04-04T14:10:09.753295+00:00",
                "created": "2025-04-04T14:01:48.839197+00:00"
            }
        ],
        "pagination": {
            "total": 145,
            "size": 10,
            "page": 1
        }
    },
    "message": null
}