Plugin feeds on XDC
Early access. Live data and the free APIs are online. Sign-ups and payments open soon.
API reference / EventHook API

EventHook API

Subscribe to XDC contract events or ERC-20/XRC-20 transfers and receive HMAC-signed HTTPS POSTs after 5 confirmations. Client keys and deliveries open with sign-ups.

Coming soonProduct: EventHook (Event webhook API) · Get started
Base pathhttps://feedplumb.com/notify
AuthenticationPer-client key in x-api-key (nk_…). Keys are issued per client at launch; each client sees only its own subscriptions.
LimitsPer-key rate limit (429) and per-plan subscription limit (403).
Health/notify/health · status page

GET /notify/health

Liveness.

curl
curl -s https://feedplumb.com/notify/health
Example response
{"ok":true}
GET /notify/health on this site

GET /notify/subscriptionsauth: x-api-key

Your subscriptions (secrets never returned).

curl
curl -s https://feedplumb.com/notify/subscriptions -H "x-api-key: nk_…"

POST /notify/subscriptionsauth: x-api-key

Create a subscription. Filter is {address, topics?} or {erc20Transfer:{token, from?, to?}}. The signing secret is returned once.

curl
curl -s -X POST https://feedplumb.com/notify/subscriptions \
  -H "x-api-key: nk_…" -H "content-type: application/json" \
  -d '{"webhookUrl":"https://example.com/hook",
       "filter":{"erc20Transfer":{"token":"0xFf7412Ea7C8445C46a8254dFB557Ac1E48094391"}}}'
Example response
{ "id": "…", "webhookUrl": "https://example.com/hook", "filter": { … }, "createdAt": "…", "secret": "…" }

GET /notify/subscriptions/{id}auth: x-api-key

One subscription without its secret.

DELETE /notify/subscriptions/{id}auth: x-api-key

Delete a subscription.

curl
curl -s -X DELETE https://feedplumb.com/notify/subscriptions/<id> -H "x-api-key: nk_…"

Errors

StatusMeaning
400invalid filter, or a private/loopback webhook URL
401missing or unknown key
403tier limit reached or admin-only filter
429rate limit
Not public: /notify/clients* (client management, admin only). These answer 404 through this domain.