Skip to main content
POST
Create subscription

Authorizations

Authorization
string
header
required

To test endpoints here, paste your API key from the dashboard into the username field and leave the password empty.

Body

application/json
callback_url
string
required

Callback URL where updates will be delivered to

Example:

"https://webhook.site/fcd606d2-f5bd-4832-9874-ff07c980b5a3"

addresses
string[]
required

Addresses of the wallets to create subscription for. Maximum 100 addresses per subscription. Note: Free tier accounts are limited to 5 addresses per subscription.

Address of the wallet.

chain_ids
string[]

Subscribe for transactions from specified chains. Leave empty to subscribe for all supported chains. You can find available chain ids in chain endpoints.

filters
object | null

Exclusion filters for the subscription. Conditions are combined with OR: an event matching any one of them is dropped and no webhook is delivered for it. Omit the field, or send null, to receive every event the subscription covers. Filters are absent from the response when none are set.

Field paths below refer to the delivered webhook transaction payload, not to this subscription resource. A condition does not match an event lacking the value it compares, so an event with no dapp is not excluded by protocol_ids.

Callbacks

POST
<your webhook URL>TransactionCallback

Body

application/json

Response for requested list of transactions

data
object
required
included
object[]

Response

Successful callback processing

Response

Response for requested wallet's transactions subscription

data
object
required