LAUNCH SNAPSHOT of ONE token, or FIRST TRADES of a LIST of up to 50 tokens
in one call (`addresses`): the first recorded trade (time, transaction,
pool, DEX, first USD price) and what happened in the first
`window_seconds` after it — trades, buys and sells, unique traders and
buyers, how many wallets traded in the very first block and in the first
10 seconds, buy / sell / total USD, the first price and the price at the
end of the window, supply at launch, and for ONE token the top 20 wallets
of that window by USD volume. Answers "how did this launch go", "how many
snipers were in the first block", "how much was bought in the first
minute", "who dumped at launch", "when did each of these tokens first
trade, at what price, on which DEX and pool". For a list of tokens pass
them all in `addresses`: one call, no loop and no SQL. NOT
token_dex_venues — its First_Trade is the first trade inside its time
window, not the token's first trade. For the full ranked list of early
wallets (sorting, minimum size, windows up to a day) use early_buyers; to
find launches use new_tokens, then pass their addresses here; for
minute-by-minute activity afterwards use token_trade_bars. Parameter
names used elsewhere map as token_address = address, network =
blockchain.
Works for rare and newly-launched tokens.
The first trade is the earliest one Bitquery holds, and trade history
reaches back about 30 days (History_Start is its first day; on Arc it starts
on 2026-09-16, when Arc trades begin), so for an older token it is a lower
bound, not the launch: when Launch_May_Predate_History = 1 the first trade
falls on that first day and the real launch may be older — say so instead
of calling it the launch. A token that stopped trading and later resumed is
also anchored at its first trade inside that history. On Solana, trades
within the same second can be recorded out of order, so First_Trade_Time is
exact but First_Tx / First_Pool can be another trade of that same second.
Window_Complete = 0 means the window has not fully elapsed yet, so the
counts are still growing.
Columns: Token_Address, Network, First_Trade_Time (first_trade_time),
First_Tx (first_tx), First_Pool (first_pool), First_Protocol
(first_protocol), Launch_May_Predate_History, History_Start, Window_Seconds
(window_seconds), Window_Complete, Supply_At_Launch (supply_at_launch — NULL
when unknown), First_Price_Usd, Last_Price_Usd_In_Window, Trades_In_Window
(trades_in_window), Buys_In_Window, Sells_In_Window,
Unpriced_Trades_In_Window, Unique_Traders_In_Window
(unique_traders_in_window), Unique_Buyers_In_Window, Wallets_In_First_Block,
Wallets_In_First_10s, Buy_Usd_In_Window (buy_usd_in_window),
Sell_Usd_In_Window (sell_usd_in_window), Volume_Usd_In_Window
(volume_usd_in_window), Top_Wallets (top_wallets). First_Price_Usd is the
first priced trade inside the window.
LIST (`addresses`; an `address` given too joins the list): one row per
token, in the order given, with the columns above except Top_Wallets, plus
Addresses_Requested, Addresses_Invalid and Addresses_Used — the rule is in
the `addresses` parameter — and Addresses_Not_Found, the addresses looked
up with no trade in the history (or none on the requested chain); [] when
every one was found, and when none is found the result is empty. The same
window_seconds applies to every token.
Top_Wallets holds up to 20 objects: trader, trades, buy_usd, sell_usd,
volume_usd, first_time_in_window, first_offset_ms (delay after the token's
first trade) and is_first_block. is_first_block = 1 when the wallet's first
trade in the window shares the block time of the token's first trade (on
chains with several blocks per second this can include the next block); a
wallet traded in the first 10 seconds when first_offset_ms < 10000, and
Wallets_In_First_10s counts those. trader is the transaction SIGNER on the
EVM chains and Solana, often a router or other contract on Tron; a bot's own
contract is found through trader_trades and the chain's tx_transfers tool.
Wallets that only SOLD inside the window
are included — tokens received without a trade and dumped at launch show up
here. USD figures value each swap at the lower of its two priced sides;
Unpriced_Trades_In_Window counts swaps without a price. Supply_At_Launch and
prices are NULL when unknown. An empty result means the address never traded
on that chain within the history.
Pass `blockchain` whenever it is known (for a list it applies to every
address); without it the chain of each token's earliest trade is used and
returned as Network.