Token

Update a webhook

Changed on

Updates an existing webhook subscription in place. Only the provided fields are changed; omitted fields keep their current value. filter replaces the hook's entire filter (token-address or token-type) in one call. For a token-address filter specifically, add_token_addresses/remove_token_addresses let you adjust the address list incrementally without resending it; they are mutually exclusive with filter and only valid when the existing (or resulting) filter is a token-address filter.

patch/v0/token/hooks/{chain}

Request

Path parameters

chain'arbitrum' | 'avalanche' | 'base' | 'bsc' | 'ethereum' | 'optimism' | 'polygon' | 'zora' | 'solana' | 'starknet' | 'starknet-sepolia' | 'stellar' | 'linea' | 'degen' | 'zksync' | 'scroll' | 'blast' | 'soneium-minato' | 'base-sepolia' | 'bitcoin' | 'abstract' | 'soneium' | 'ink' | 'berachain' | 'unichain' | 'ronin' | 'sui' | 'hedera' | 'hyperevm' | 'xlayer' | 'monad' | 'megaeth' | 'tempo' | 'sei' | 'kaia' | 'tron' | 'robinhood' | 'flare' | 'arc' required

The chain name

Request body

urlstring uri nullable

If provided, replaces the hook's url

shared_secret_keystring nullable

If provided, replaces the hook's shared secret key

add_token_addressesstring[] nullable

Token addresses to add to the hook's existing token_address filter, without having to resend the full list. Mutually exclusive with filter.

remove_token_addressesstring[] nullable

Token addresses to remove from the hook's existing token_address filter. Mutually exclusive with filter.

Response

Successful Response

urlstring uri required
shared_secret_keystring nullable

Optional shared secret key (32 characters), used to calculate the HMAC signature

chain'arbitrum' | 'avalanche' | 'base' | 'bsc' | 'ethereum' | 'optimism' | 'polygon' | 'zora' | 'solana' | 'starknet' | 'starknet-sepolia' | 'stellar' | 'linea' | 'degen' | 'zksync' | 'scroll' | 'blast' | 'soneium-minato' | 'base-sepolia' | 'bitcoin' | 'abstract' | 'soneium' | 'ink' | 'berachain' | 'unichain' | 'ronin' | 'sui' | 'hedera' | 'hyperevm' | 'xlayer' | 'monad' | 'megaeth' | 'tempo' | 'sei' | 'kaia' | 'tron' | 'robinhood' | 'flare' | 'arc' required

The chain name

activeboolean required
created_atstring date-time required
updated_atstring date-time required

Changes