Skip to main content

List Node Payments

Lists the settled transfers out of a node's wallets, newest first, with pagination. A payment is written when a Withdraw is confirmed on chain; it records where the funds went, how much and the transaction hash. To follow a withdrawal that has not settled yet, use List Node Transactions.

Required permission: node:transactions:view

Request​

GET /v2/admin/nodes/{node_id}/payments

Parameters​

NameTypeInDescription
node_idstringpathRequired. The node's id
wallet_idstringqueryOnly payments sent from this custody wallet
network_idstringqueryOnly payments sent on this network
pageintegerqueryRequired. Page number, starting at 1
per_pageintegerqueryRequired. Items per page, 1–100

Headers​

NameDescription
AuthorizationRequired. Bearer <access_token>

Example​

curl --request GET \
--url '{{baseUrl}}/v2/admin/nodes/6a4bef2b1e781b11c22e9707/payments?wallet_id=6a53f3dfad48accdb46eaf9e&page=1&per_page=10' \
--header 'Authorization: Bearer <access_token>'

Response​

{
"data": [
{
"id": "690dfa7dbccf5473e338b6ac",
"node_id": "6a4bef2b1e781b11c22e9707",
"wallet_id": "6a53f3dfad48accdb46eaf9e",
"network_id": "6740e0a20000000000000101",
"address": "0x1493Ad169f118c260A8597bfe0A72f8262E9f4bA",
"type": 1,
"price": {
"amount": "1.5",
"decimal": 18,
"symbol": "ETH"
},
"hash": "0xa4d1bbe5bc5309bce7c44c0c8259e4b8d59b80b7395e4acc047968340897c357",
"created_at": "2026-10-29T20:33:13.52Z"
}
],
"total": 1,
"page": 1,
"per_page": 10
}

Response Fields​

FieldTypeDescription
dataarrayThe payments
data[].idstringPayment id
data[].node_idstringThe node the payment belongs to
data[].wallet_idstringThe custody wallet the funds left from
data[].network_idstringThe network the transfer ran on
data[].addressstringRecipient address
data[].typeintegerPayment type. 1 = withdrawal
data[].priceobject | nullWhat was sent
data[].price.amountstringAmount, as a decimal string. See Amounts and Percentages
data[].price.decimalintegerDecimal places of the asset
data[].price.symbolstringAsset symbol
data[].hashstringOn-chain transaction hash
data[].created_atstringWhen the payment was recorded (ISO 8601)
totalintegerNumber of payments matching the filters
pageintegerPage number
per_pageintegerItems per page

Errors​

StatusCodeDescription
40010015Validation failed (for example a missing page or per_page) — see details
40010016node_id is not a valid id
40010001Node not found (node domain 2)
40310005The node is outside your part of the hierarchy (node domain 2)
50010000wallet_id or network_id is not a valid id

See Errors for the error format and common codes.