Data Model & Enums
The conventions and enumerations shared across every endpoint. Domain-specific vocabularies (badges, bundle types, reason codes) are defined in full on their own pages and indexed at the bottom.
Conventions
| Concern | Convention |
|---|---|
| Raw vs UI amounts | *_raw / *_amount_raw are raw on-chain units; UI amounts are raw / 10^decimals. Both are sent as decimal strings on stream payloads to preserve precision — parse with a decimal library, not parseFloat. |
| Timestamps | Unix milliseconds unless a field is named *_seconds or *_ts in seconds (noted per field). |
| Prices | USD per token; sol_price_usd is SOL/USD captured at trade time. |
| Fees | Reported in both *_lamports and *_usd. |
| Pagination | limit + offset; list responses return nextOffset (pass it back as offset; null ⇒ exhausted). |
| IDs | signature (tx), trade_id = {signature}:{event_index}, bundle_id, entity_id, campaign_id. |
DEX venues
dex_name, entry_dex, and exit_dex resolve to one of the parsed venues:
Raydium · Raydium_CPMM · Raydium_CLMM · PumpFun · PumpSwap · BonkFun · Meteora_DLMM · Meteora_DAMM_V2 · Meteora_DBC · Whirlpool · Phoenix · PancakeSwap · Aquifer · Solfi · Humidifi · Boop · Moonshot · Multi · Unknown
(Multi = a multi-venue route; Unknown = an unrecognized program.)
Core enums
| Enum | Values |
|---|---|
| Trade direction | buy · sell · swap · flash_swap |
| Position status | OPEN · PARTIAL · CLOSED |
| Exit type | FULL · PARTIAL |
| Position type | FULL_POSITION · DCA_EXIT · ARBITRAGE |
| Token validation status | pending · processing · validated · suspicious · rugged |
| Holder hydration status | hydrating · hydrated · born_forward · partial_forward |
| Account class | human · pool · curve · program_account |
Domain vocabularies
Defined in full on the pages that use them:
| Vocabulary | Where |
|---|---|
Trade & identity badges (TERMINAL: / BOT: / MEV: / BUNDLE:) | Swaps & Trade Tape, Labels & Taxonomy |
Trader taxonomy (trader_type, performance_level, size_class, exit_style) | Labels & Taxonomy |
Holder labels (HOLDER:TOP_10, HOLDER:OG, …) | Holder Labels |
| Bundle types, lifecycle status & markers | Bundles, Bundle Lifecycle & Markers |
Funding-abuse reason codes (SEED_WAVE_HEAVY, …) | Funding Abuse |
| Entity kinds, campaign status, crowd regime | Follows, Entities & Campaigns |
| Token score dimensions | Token Health Score |
Scores you’ll see across the API — risk_score, skill_score, funding-abuse score, follow/entity confidence, crowdScore, the token-health composite — are calibrated outputs. Build product logic on the labeled statuses, evidence/reason arrays, and confidences; don’t reverse-engineer the underlying weighting.