List Addresses

GET

API for retrieving the addresses monitored by an ADDRESS_ACTIVITY event type Webhook, with pagination. Prefix search on addresses is supported via search.

Path Parameters

chainstringrequired

Parameter specifying the target chain to query.

networkstringrequired

Parameter specifying the network of the target chain.

subscriptionIdstringrequired

Parameter that specifies the subscriptionId assigned to the ADDRESS_ACTIVITY Webhook.

Query Parameters

pageinteger

Specifies the page to query. The default is 1.

sizeinteger

Specifies the number of addresses to query per page. The valid range is 1 to 1,000. The default is 100.

sortstring

Sort criteria. createdAt sorts by registration time, and address sorts alphabetically. The default is createdAt.

orderstring

Sort direction. Enter asc or desc. The default is asc.

searchstring

Address prefix matching. The entered address is normalized to lowercase for matching.

Responses

List of retrieved addresses.

addressstringrequired

EVM address. (0x + 40 hex, case-insensitive — normalized to lowercase for storage.)

createdAtstringrequired

Address registration time. Returned in ISO 8601 format.

totalintegerrequired

Total number of addresses in the set after applying search.

pageintegerrequired

Current page number of the query.

sizeintegerrequired

Number of addresses per page returned based on the request.

codestringrequired

Code identifying the cause of the failed request.

messagestringrequired

Detailed message including the name and value of the invalid parameter.

{
  "code": "MISSING_REQUIRED_PARAMETER",
  "message": "Missing required parameter: { PARAMETER_NAME }"
}

X-API-KEY

cURL

curl -X GET 'https://web3.nodit.io/v1/arbitrum/mainnet/webhooks/1234567890/addresses?search=0xabc' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo'