Swaps

Enriched on-chain swap tape.

swaps is the customer-facing market-data tape.

Filters

FilterMeaning
pairNormalized pair label, for example SOL-USDC
poolExact pool address, when the event maps to a known pool
sourceSwap source where available

swaps emits only events that satisfy the V1 enrichment contract. If the gateway cannot resolve pair direction, token metadata, AMM metadata, amount normalization, and price, the event is dropped from the customer stream and counted in metrics.

Payload

{
  "type": "swap",
  "processed_at_ms": 1783348800000,
  "contract_version": "market_data.v1",
  "trade": {
    "event_id": "430700000:12:3:0",
    "signature": "5x...",
    "slot": 430700000,
    "tx_index": 12,
    "instruction_index": 3,
    "instruction_path": "3",
    "fee_payer": "FeePayer111111111111111111111111111111111",
    "processed_at_ms": 1783348800000,
    "source": "jupiter",
    "amm_program": "ExampleProgram111111111111111111111111111",
    "amm": "BisonFi",
    "amm_model": "AMM",
    "pool_address": "ExamplePool11111111111111111111111111111111",
    "pair": "SOL-USDC",
    "base": {
      "mint": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "decimals": 9,
      "amount": "1250000000",
      "ui_amount": 1.25,
      "ui_amount_string": "1.25"
    },
    "quote": {
      "mint": "USDC_MINT",
      "symbol": "USDC",
      "decimals": 6,
      "amount": "101410000",
      "ui_amount": 101.41,
      "ui_amount_string": "101.41"
    },
    "taker_side": "buy_base",
    "price": 81.128
  }
}

processed_at_ms is the time edge-onchain-indexer processed the on-chain event. event_id is opaque and stable for deduplication; do not depend on its internal construction.