Data model

Schema · Early tokens

The new Convex and Parquet tables that capture a token from deployment through its first hours.

The early-token domain adds five Convex tables and three Parquet datasets, and refines tokens, token_contracts, opportunities and score_snapshots (full versions on the Convex schema page).

Convex · operational

token_launches — the main early-launch table

Field	Type	Description
`id`	ID	Launch identifier
`token_id`	ID	Related token
`token_contract_id`	ID	Related contract
`chain_id`	ID	Blockchain
`launch_platform`	string	Launchpad or protocol
`launch_type`	string	Contract, bonding curve, fair launch, DEX pool
`status`	string	Lifecycle status
`deployed_at`	datetime, optional	Contract deployment
`launch_started_at`	datetime, optional	Launch mechanism started
`pool_created_at`	datetime, optional	Pool creation
`first_liquidity_at`	datetime, optional	First usable liquidity
`first_trade_at`	datetime, optional	First trade
`migration_started_at`	datetime, optional	Migration start
`migration_completed_at`	datetime, optional	Migration completion
`initial_liquidity`	decimal, optional	Initial liquidity
`initial_price`	decimal, optional	First usable price
`initial_market_cap`	decimal, optional	Initial market cap
`initial_fdv`	decimal, optional	Initial FDV
`creator_wallet`	string, optional	Creator wallet
`first_detected_at`	datetime	Clawlas detection
`discovery_latency_ms`	integer, optional	Detection delay
`data_maturity`	string	Minimal, early, partial, mature
`created_at`	datetime	Record creation
`updated_at`	datetime	Last update

launch_events — immutable lifecycle events

Field	Type	Description
`id`	ID	Event identifier
`token_launch_id`	ID	Parent launch
`event_type`	string	Deployment, liquidity, first trade, migration
`event_at`	datetime	Actual event time
`detected_at`	datetime	Detection time
`source_id`	ID	Data source
`source_event_id`	string, optional	External identifier
`confidence`	number	Event confidence
`payload_reference`	string, optional	Raw analytical reference
`created_at`	datetime	Record creation

liquidity_pools

Field	Type	Description
`id`	ID	Pool identifier
`token_launch_id`	ID	Related launch
`token_id`	ID	Base token
`chain_id`	ID	Blockchain
`exchange_id`	ID	DEX
`pool_address`	string	Pool address
`quote_token_symbol`	string	Quote asset
`pool_type`	string	AMM, concentrated liquidity, bonding curve
`created_at_chain`	datetime	On-chain creation time
`first_detected_at`	datetime	Detection time
`current_status`	string	Active, low liquidity, removed, inactive
`current_liquidity`	decimal	Latest liquidity
`liquidity_locked`	boolean, optional	Lock state
`liquidity_burned`	boolean, optional	Burn state
`created_at`	datetime	Record creation
`updated_at`	datetime	Last update

security_assessments

Field	Type	Description
`id`	ID	Assessment identifier
`token_contract_id`	ID	Assessed contract
`token_launch_id`	ID, optional	Related launch
`assessed_at`	datetime	Assessment time
`assessment_version`	string	Scanner version
`security_score`	number	Computed score
`honeypot_probability`	number	Estimated risk
`buy_tax`	number, optional	Detected buy tax
`sell_tax`	number, optional	Detected sell tax
`mint_risk`	boolean	Mint-related risk
`freeze_risk`	boolean	Freeze-related risk
`blacklist_risk`	boolean	Blacklist capability
`pause_risk`	boolean	Pausable trading
`upgrade_risk`	boolean	Upgrade authority
`liquidity_removal_risk`	number	Liquidity risk
`blocking_flags`	array	Hard blocking conditions
`evidence`	object	Structured evidence
`created_at`	datetime	Record creation

sellability_tests

Field	Type	Description
`id`	ID	Test identifier
`token_launch_id`	ID	Related launch
`liquidity_pool_id`	ID, optional	Tested pool
`wallet_profile`	string	Simulation profile
`tested_at`	datetime	Test time
`status`	string	Pass, limited, fail, blocked
`test_method`	string	Simulation, quote, controlled transaction
`test_quantity`	decimal	Tested amount
`expected_output`	decimal, optional	Expected proceeds
`estimated_slippage`	number, optional	Expected slippage
`estimated_tax`	number, optional	Estimated tax
`gas_estimate`	decimal, optional	Estimated gas
`failure_reason`	string, optional	Failure explanation
`expires_at`	datetime	Validity expiration
`created_at`	datetime	Record creation

Parquet · analytical

early_token_snapshots — chain / launch_platform / date / token_launch_id

Field	Type
`token_launch_id`	string
`token_id`	string
`liquidity_pool_id`	string, optional
`captured_at`	datetime
`contract_age_seconds`	integer, optional
`launch_age_seconds`	integer, optional
`tradable_age_seconds`	integer, optional
`pool_age_seconds`	integer, optional
`price`	decimal, optional
`market_cap`	decimal, optional
`fdv`	decimal, optional
`liquidity`	decimal
`buy_count`	integer
`sell_count`	integer
`unique_buyers`	integer
`unique_sellers`	integer
`buy_volume`	decimal
`sell_volume`	decimal
`net_buy_pressure`	number
`transaction_velocity`	number
`holder_count`	integer, optional
`top_10_percentage`	number, optional
`creator_percentage`	number, optional
`sniper_percentage`	number, optional
`bot_activity_score`	number
`social_velocity`	number, optional
`estimated_buy_slippage`	number
`estimated_sell_slippage`	number
`sellability_status`	string
`security_score`	number
`data_quality_score`	number

launch_wallet_activity

Field	Type
`token_launch_id`	string
`wallet_address`	string
`wallet_role`	string
`related_creator_probability`	number
`first_seen_at`	datetime
`event_at`	datetime
`event_type`	string
`quantity`	decimal
`estimated_value`	decimal, optional
`balance_after`	decimal, optional
`wallet_age_seconds`	integer, optional
`behavior_score`	number
`cluster_id`	string, optional

launch_liquidity_events

Field	Type
`token_launch_id`	string
`liquidity_pool_id`	string
`event_at`	datetime
`event_type`	string
`provider_wallet`	string, optional
`base_amount`	decimal
`quote_amount`	decimal
`liquidity_value`	decimal
`pool_liquidity_after`	decimal
`transaction_hash`	string
`block_number`	integer

Enumerations

Wallet roles: CREATOR · DEPLOYER · RELATED_WALLET · EARLY_BUYER · SNIPER · BOT · WHALE · MARKET_MAKER · EXCHANGE · UNKNOWN. Liquidity events: POOL_CREATED · LIQUIDITY_ADDED / REMOVED / LOCKED / UNLOCKED / BURNED.

The early-token opportunity_outcomes dataset extends the analytics schema with sub-second return windows (return_5s … return_30d) and rug/migration flags.