List Addresses - Webhooks API
List Addresses - Returns the addresses watched by a subscription, page by page
List Addresses - [Value: 20CU]
Returns the addresses watched by a subscription, sorted, with cursor pagination. Transactions before an address's activated_at are never delivered
GET https://lb.drpc.live/lambda/{key}/v1/webhooks/subscriptions/{id}/addresses
Use cases
- Page through all addresses of a subscription
- Check when an address started being watched
Constraints
- Up to 1000 addresses per page
- Sorted output: paging never repeats or skips an address
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key
Language
Request
Examples
curl --request GET \
--url https://lb.drpc.live/lambda/{key}/v1/webhooks/subscriptions/0450d9f4-304f-420f-9b49-3625d9c52c1f/addresses?limit=100 \
--header 'accept: application/json'Response
200
{
"items": [
{
"address": "0x04fc43d86deee3185b77f0d520d8932462814e02",
"activated_at": "2026-09-21T12:52:46.024339Z"
}
],
"next_cursor": "MHgwNGZjNDNkODZkZWVlMzE4NWI3N2YwZDUyMGQ4OTMyNDYyODE0ZTAy"
}Path params
keystring
[Required] Your dRPC API key
idstring
[Required] Subscription id (UUID) returned on create
Query params
limitinteger
1 to 1000. Default: 100
cursorstring
The previous page's next_cursor; leave it out for the first page
Request params
Response
200
Response params
object
itemsarray
[Required] Watched addresses on this page
object
addressstring
[Required] Watched address, lowercase
activated_atstring
[Required] When the address started being watched. Removing and adding the address back keeps its first activated_at
next_cursorstring
Cursor for the next page. null on the last page