For the complete documentation index, see llms.txt. This page is also available as Markdown.

πŸ“¦Example Payloads

Real webhook deliveries (sanitized) for the most common event types, so you can build and test your receiver against actual payload shapes.

Below are real deliveries captured from live webhooks, one per common event_type. Wallet addresses and transaction hashes have been replaced with obvious placeholders; token mints, pools, and program IDs are real, so you can look them up.

Every delivery arrives as an HTTPS POST with the headers described in Webhooks API β†’ Delivery Payload. The X-RayBot-Event header matches the body's event_type.

Common structure

All payloads share the same top-level shape:

  • id β€” the transaction signature (Solana) or transaction hash (EVM).

  • event_type β€” transfer_in, transfer_out, buy, sell, etc.

  • chain / source β€” network and the program or platform that produced the event.

  • failed β€” true if the transaction failed on-chain.

  • fee_payer β€” who paid for the transaction.

  • followed_wallets β€” which of your tracked addresses triggered this delivery, with the wallet_name you assigned.

  • token_changes β€” balance deltas per tracked address: direction (in/out), mint, raw and decimal amount, and USD pricing.

  • tokens β€” metadata for every mint referenced in token_changes (symbol, decimals, price, supply, socials).

  • position β€” present on buy/sell events only: running position stats for the wallet and token (cost basis, invested total, realized/unrealized PnL).

  • fees β€” priority fee and tips paid.

  • event β€” the raw parsed event; its shape varies by chain and event type (EVM events include the low-level transfers breakdown).


SOLANA β€” SOL transfer (transfer_in)

A plain SOL transfer into a followed wallet, sent via the System Program.


EVM β€” Native transfer (transfer_in)

A native ETH transfer into a followed wallet on Base. Native currency is reported through the chain's wrapped-token mint (WETH at 0x4200…0006 on Base).


SOLANA β€” Buy (buy)

A followed wallet swaps SOL for Bonk on Orca. Note the two token_changes entries (SOL out, token in) and the position block with the running position stats.


EVM β€” Sell (sell)

A followed wallet sells a token for WETH. The event.transfers.events array lists every low-level transfer in the transaction β€” router hops, fee transfers, and the final payout back to the wallet. position.is_closed: true means this sale closed the position.

Last updated