Webhooks - Watched Addresses

Add a watched wallet address

Add a wallet so address scoped event types can report on it. Adding a wallet that is already watched changes nothing and does not count against the cap again. Hyperliquid bridge system addresses are refused, because such an address is a counterparty to every bridge movement of its token rather than an account. A plan without webhook delivery, or one already at its watched wallet cap, is refused with the reason and the way forward. Authenticate with an API key or a signed-in dashboard session. Costs no credits.

post/v1/webhooks/addresses

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/webhooks/addresses
  • Auth: API key in header X-API-Key

Request body

addressstring required

A 0x prefixed 40 hex character wallet address. Stored lowercase.

labelstring

Your own label for the wallet. At most 64 characters.

Example request

{
  "address": "0x6b9e773128f453f5c2c60935ee2de2cbc5390a24",
  "label": "Desk 1"
}

Response

The watched wallet address

successboolean
limitinteger

Watched wallets this plan allows.

Example response

{
  "success": true,
  "data": {
    "address": "0x6b9e773128f453f5c2c60935ee2de2cbc5390a24",
    "label": "Desk 1"
  },
  "limit": 15
}

Changes

No recorded changes to this operation across all 1 revision of this API.