Public Reference

Liquidity Event Reference

Liquidity events cover both add and remove directions through one schema. Route by txType instead of assuming one direction from the page alone, and do not fake certainty where the live stream does not have it yet.

Overview JSON Contract Create Trade Migration CreatePool Liquidity Burn

Current public schema

schemaVersion: liquidity_event_v1
source: parsed_tx
txType: add or remove
tokensInPool and solInPool are allowed only when derivable from the current parsed transaction.

Observed add path

Honest current state: a fresh real addLiquidity payload has not been captured in the latest pass yet, so the page documents the contract but does not invent a fake live add example.

Observed remove payload

{
  "schemaVersion": "liquidity_event_v1",
  "signature": "29VK4NCy6Z9V4p5FfMfRkrBbAUuqohM94FFMKZyGBk3TcZMMvfTSVPAZAhjZVLwqyA9dbHxysr5zg6RAgxURjAet",
  "mint": "DeT7F7zHnrVDSWMgCwcw8zDh58yiunFf7EyqsCS7boHF",
  "txType": "remove",
  "pool": "pump-swap",
  "poolCreatedBy": null,
  "poolId": "BpA29pLCmYhxpx6cT4CPbp1zgTXnTYg674J8knthUG3L",
  "price": 0.0000012357120790855732,
  "source": "parsed_tx",
  "slot": 409019854,
  "block": 409019854,
  "poolProgramId": "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA",
  "instructionName": "Withdraw",
  "hasError": false,
  "timestamp": 1774541477000,
  "txSigner": "893HQe5qsTmGxAMduhUWDJki5Hz7f7V5ExazwD8oXPUZ",
  "lpMint": "GsJrZZgeumwqzyiXrzYoKrwnZxn7mxeAcurVvRaE5SiA",
  "lpAmount": 25495097580611,
  "baseVault": "39WYKRTM4oUYvPPnfdWTzo7EDPR5t56sn5y1ygTNc4AK",
  "quoteVault": "HmTBkDH7HbvWwwFBm58kMorSjWX1c95adq7cn65C8gX4",
  "baseMint": "DeT7F7zHnrVDSWMgCwcw8zDh58yiunFf7EyqsCS7boHF",
  "quoteMint": "So11111111111111111111111111111111111111112",
  "baseAmount": 825190689.284761,
  "quoteAmount": 920.545497507,
  "tokensInPool": 0.003237,
  "solInPool": 4e-9
}

Client guidance

Guaranteed core

Clients can rely on signature, mint, txType, pool, poolId, source, slot, block, vaults, mint pair, and amount fields present in the event.

Do not over-assume

poolCreatedBy can stay null, lpMint and lpAmount are conditional, and the same schema covers both directions, so branch on txType every time.