List Addresses

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

Use cases

  • Page through all addresses of a subscription
  • Check when an address started being watched
Constraints

Constraints

  • Up to 1000 addresses per page
  • Sorted output: paging never repeats or skips an address
Get started
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'
Copy
Response
200
{
  "items": [
    {
      "address": "0x04fc43d86deee3185b77f0d520d8932462814e02",
      "activated_at": "2026-09-21T12:52:46.024339Z"
    }
  ],
  "next_cursor": "MHgwNGZjNDNkODZkZWVlMzE4NWI3N2YwZDUyMGQ4OTMyNDYyODE0ZTAy"
}
Copy

Path params

Parameters
keystring
[Required] Your dRPC API key
idstring
[Required] Subscription id (UUID) returned on create

Query params

Parameters
limitinteger
1 to 1000. Default: 100
cursorstring
The previous page's next_cursor; leave it out for the first page

Request params

ParametersThis method does not accept any parameters.

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