Console

GETList Address Sets

Webhook APIhttps://web3.nodit.io/v1/webhook/address-sets

API for retrieving the list of Address Sets created in the project, with pagination. Specify the page with page and rpp. Both the default and the maximum of rpp are 100.

Query Parameters
pageinteger

Specifies the page to query. The default is 1.

rppinteger

Specifies the number of Address Sets to query per page. The valid range is 1 to 100. The default is 100.

Responses
totalintegerrequired

Total number of Address Sets matching the query.

예: 1

pageintegerrequired

Current page number of the query.

예: 1

rppintegerrequired

Number of Address Sets per page returned based on the request.

예: 100

addressSetIdstringrequired

Field indicating the addressSetId assigned to the Address Set. The addressSetId is a unique value that identifies the Address Set and is used to retrieve, update, or delete it. It is a 19-digit number but is returned as a string in JSON. Parsing it as a number in JavaScript or similar environments loses precision, so always handle it as a string.

예: 1788439512345678901

namestringrequired

Field indicating the name of the Address Set. Up to 128 characters.

예: exchange-hot-wallets

descriptionstringrequired

Field indicating the description of the Address Set. Up to 512 characters; an empty string ("") for a set without a description.

예: Hot wallets monitored for deposits

addressFormatstring (enum)required

Field indicating the format of addresses stored in the Address Set. Either EVM or TRON; it cannot be changed after creation.

예: EVM

statusstring (enum)required

Field indicating the status of the Address Set. READY means addresses can be changed and the set can be attached to Webhooks; IMPORTING means a CSV import is in progress. While the status is IMPORTING, addresses cannot be changed and the set cannot be attached to a Webhook (name and description can still be updated). A deleted set stops being retrievable immediately after deletion (404), so no separate deletion status appears in responses.

예: READY

addressCountintegerrequired

Field indicating the total number of addresses stored in the Address Set.

예: 100000

webhookCountintegerrequired

Field indicating the number of Webhooks currently using this Address Set. The set cannot be deleted when this value is 1 or more.

예: 0

createdAtstring (date-time)required

Indicates when the Address Set was created. This field is returned in ISO 8601 format.

예: 2026-07-01T00:00:00.000Z

updatedAtstring (date-time)required

Indicates when the Address Set was last modified. This field is returned in ISO 8601 format.

예: 2026-07-01T00:00:00.000Z

X-API-KEY
Request
cURL
curl -X GET "https://web3.nodit.io/v1/webhook/address-sets?page=1&rpp=100" \
  -H "X-API-KEY: {YOUR_API_KEY}"
Response
Example · 200
{
  "total": 1,
  "page": 1,
  "rpp": 100,
  "items": [
    {
      "addressSetId": "1788439512345678901",
      "name": "exchange-hot-wallets",
      "description": "Hot wallets monitored for deposits",
      "addressFormat": "EVM",
      "status": "READY",
      "addressCount": 100000,
      "webhookCount": 0,
      "createdAt": "2026-07-01T00:00:00.000Z",
      "updatedAt": "2026-07-01T00:00:00.000Z"
    }
  ]
}

Last updated