Wallet Webhooks

Wallet transaction pending

Triggered when the wallet.transaction.pending webhook event is emitted. Your API will receive a POST request at the webhook URL you configured.

postWebhookwalletTransactionPending

Payload

transaction_hashstring required

The onchain transaction hash.

addressstring required

A blockchain address. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana).

network'base' | 'ethereum' | 'solana' | 'aptos' | 'arbitrum' | 'arbitrum-sepolia' | 'optimism' | 'polygon' | 'world' | 'world-sepolia' required

The blockchain network for the payment. Supported networks depend on the account type.

pending_sincestring date-time required

When the transaction entered the pending state (ISO 8601 format).

max_fee_per_gasstring required

EIP-1559 max fee per gas in wei.

max_priority_fee_per_gasstring required

EIP-1559 max priority fee per gas in wei.

user_idstring required

The user ID that owns the User Wallet.

delegation_idstring required

The delegation grant ID used to authorize the action.

Example payload

{
  "transaction_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "network": "base",
  "pending_since": "2025-06-01T10:04:00Z",
  "max_fee_per_gas": "30000000000",
  "max_priority_fee_per_gas": "1500000000",
  "user_id": "user_12345",
  "delegation_id": "delegation_af2937b0-9846-4fe7-bfe9-ccc22d935114"
}

Response

Webhook received and processed successfully.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.