What the models can see

A model cannot browse, read a website, or see anything a token's deployer wrote. It has nine tools, and the market data they return comes from the round's one snapshot, so all four models read identical numbers.

Tool	Answers
scan_launches	What launched recently, newest first. Defaults to the last hour, reaches back seven days.
trending	What is moving: by volume, holders, price change, or holder growth. Ranks the last seven days unless asked to include older tokens.
inspect	One token, close up: its liquidity, market cap, holders, a bytecode scan, and a live buy-then-sell simulation.
price_history	One-minute candles, up to the last completed minute.
portfolio	Cash, equity, gas, realised and unrealised PnL, and every open position.
journal	The model's own past turns, with what it decided and why.
buy / sell	A trade request. Checked against the guardrails and refused with a reason if it is outside them.
hold	Do nothing this round, with a stated reason.

Every result also carries how many calls are left in the turn.

Null means unmeasured, never zero

Several fields are only reported by some sources. Where a source reported nothing, the field is null — it is never filled in with a zero, because a zero reads as a measurement ("nobody is buying") when the truth is that nobody measured. The system prompt tells the models this in as many words.

The same rule shapes two field pairs. Holder growth is reported as a change and the real gap it was measured over, never as a rate named for a window it did not measure. And the market cap always travels with its source: either the figure the market data reported, or one computed from the token's total supply and its price. A token whose market cap cannot be established either way cannot be bought at all.

scan_launches

Field	Type	Notes
token	Address
symbol	string
ageSeconds	number
launchpad	string | null
liquidityUsd	number
vol5mUsd	number
holders	number | null
buys5m	number | null	5-minute buy and sell counts, and buys per sell. Null means unmeasured, not zero.
sells5m	number | null
buySellRatio5m	number | null
holderDelta	number | null	Holders gained since the previous sample, and the real gap it covers. Read them together: the gap is usually half an hour or more, so this is not a five-minute signal. Both null until a token has two samples.
holderWindowSeconds	number | null
marketCapUsd	number | null	Market cap in dollars and where it came from: "dexscreener" is reported, "derived" is total supply × price. Null when neither could be established.
marketCapSource	"dexscreener" | "derived" | null
priceUsd	string
chg5mBps	number

trending

Field	Type	Notes
token	Address
symbol	string
ageSeconds	number | null
liquidityUsd	number
volUsd	number
holders	number | null
buys5m	number | null	5-minute buy and sell counts, and buys per sell. Null means unmeasured, not zero.
sells5m	number | null
buySellRatio5m	number | null
holderDelta	number | null	Holders gained since the previous sample, and the real gap it covers. Both null until a token has two samples.
holderWindowSeconds	number | null
marketCapUsd	number | null	Market cap in dollars and where it came from: "dexscreener" is reported, "derived" is total supply × price. Null when neither could be established.
marketCapSource	"dexscreener" | "derived" | null
priceUsd	string
chg5mBps	number
chg1hBps	number
chg24hBps	number

inspect

Field	Type	Notes
token	Address
symbol	string | null
ageSeconds	number | null
liquidityUsd	number | null
marketCapUsd	number | null	Market cap in dollars and its source ("dexscreener" reported, "derived" total supply × price); null when unknown.
marketCapSource	"dexscreener" | "derived" | null
holders	number | null
top10Pct	number | null
holdersAt	string | null	When the holder data was fetched (ISO); null when never. A failed lookup keeps the last data and its time.
lpStatus	"unknown"
deployer	{ address: null; priorTokens: null }
bytecodeFlags	string[]
roundtrip	InspectRoundtrip | null
blocked	InspectBlocked | null
notes	string[]

InspectRoundtrip

Field	Type	Notes
buyUsd	number
tokensOut	string	Whole tokens received in the simulated buy, as a decimal string.
sellUsdBack	number
roundtripBps	number
ok	boolean

portfolio

Field	Type	Notes
cashUsd	number
equityUsd	number
ethForGas	string	ETH, as a decimal string.
pnlRealizedUsd	number
pnlUnrealizedUsd	number
tradesLeftThisTick	number
positions	PortfolioPosition[]

PortfolioPosition

Field	Type	Notes
token	Address
symbol	string
qty	string	Whole tokens, as a decimal string.
avgCostUsd	string
priceUsd	string
marketCapUsd	number | null	Market cap in dollars and its source ("dexscreener" reported, "derived" total supply × price); null when unknown.
marketCapSource	"dexscreener" | "derived" | null
valueUsd	number
pnlPct	number | null
openedAt	string
multipleSinceEntry	number | null	Current price over the average entry price: 1.0 is break-even, 2.0 is a double. Null when the entry price is unknown.
peakMultiple	number | null	The highest price seen since entry (minute candles, this tick's price and the entry itself), over the entry price. Never below 1.0.
drawdownFromPeakPct	number | null	How far the current price sits below that peak, in percent; 0 when the price is at its peak.
minutesHeld	number	Minutes since the position was opened, at this tick.
minutesSincePeak	number | null	Minutes since the peak was set, at this tick; equals minutesHeld when the entry is still the peak.