# QUERY

> Ask in plain words, get the live launchpad coins (pump.fun, Raydium LaunchLab, bonk.fun) that match. No key needed.

## Ask
GET /api/ask?q=<your sentence>
Example: /api/ask?q=AI+coins+that+migrated+in+the+last+hour+with+a+real+site+under+$100k

Returns JSON:
- chips: the filters QUERY read from your sentence
- steps: the funnel (label + coins left after each filter)
- results: [{ mint, lp (launchpad), name, symbol, mcap, liq, holders, vol1h, pc1h, gradAgo (ms since migration), ageMs, website, siteOk, siteTitle, twitter, tags }]
- near: if fewer than asked, the filter that killed it and the closest coins without it
- quota: free asks left today (3 per IP; holders of 1,000,000 $QUERY are unlimited)

## What it understands
Categories: ai, tech, dog, cat, frog, animal, politics, space, game, anime, sports, finance, celeb, food, or any word.
Launchpad: "raydium", "bonk", "pump.fun".
Time: "last 30 min", "last hour", "last 3h", "today". Status: "migrated", "about to bond".
Ranges: "under $100k", "between 50k and 300k", "liq over 20k", "500+ holders", "volume over 50k".
Must-haves: "real site", "twitter", "telegram". Sort: "pumping", "newest", "most holders", "biggest", "smallest", "organic". Count: "top 5" (max 10).

## Other endpoints
GET /api/board — every coin in the pool right now
GET /api/stats — asks today, buys routed, recent asks

## Sources
Jupiter launchpad feeds (pump.fun, Raydium LaunchLab, bonk.fun), Jupiter Tokens API v2, on-chain token metadata, Jupiter Ultra (swaps), Solana RPC.