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
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: ••••••' \
{
"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
}Last updated