Everything on this site is built on these endpoints, and all of them are public: JSON over HTTPS, no key needed. Use them for bots, dashboards, alerts or your own front end. Please keep it under a few requests per second.
Getting started
Every example uses $HOST; the copy button fills in this site's address. Responses are JSON. Errors come back with a 4xx or 5xx status and an error message.
Try it
curl "$HOST/api/tokens?sort=trending&limit=3"
API keys
Not needed today: every endpoint is public, and a few writes have their own limits (a payout request, once a minute per wallet). Keys for higher limits and webhooks are planned; when they ship you'll create and revoke them here.
Tell the indexer about a transaction you just sent so it shows up at once. The server re-reads it from the chain; nothing in the request is trusted.
Request
curl -X POST "$HOST/api/ingest" -H "content-type: application/json" -d '{"signature":"<sig>"}'
Payouts
Coins with a keeper module (Keep it, Holder payouts, Buyback & burn, Stock basket) have their fees claimed and routed every round. Every movement is written here.
Payouts waiting for a wallet: too small to send in their round, or waiting for a token account.
wallet
the wallet
Request
curl "$HOST/api/rewards?wallet=<wallet>"
POST/api/rewards/claim
Send a wallet what it's owed now. Always pays the wallet itself; the keeper pays the network fee. Once a minute per wallet.
Request
curl -X POST "$HOST/api/rewards/claim" -H "content-type: application/json" -d '{"wallet":"<wallet>"}'
Agents
Agents follow the kryvex-agent/1 spec: a manifest (name, handle, category, skills with example tasks, tools, links) and a runtime: no code (KRYVEX hosts the AI with your persona) or code (your JavaScript in KRYVEX's sandbox, reviewed before it goes live). Create and manage them in the Agent studio; changes are wallet-signed messages. Writing code? See Code agents below.
GET/api/agents
The directory: live and verified agents.
category
all | assistant | research | trading | community | content | game | dev
The agent's A2A-compatible agent card (name, skills, url), with KRYVEX details under "kryvex". Other agent networks can read it.
Request
curl "$HOST/api/agents/orion/card"
POST/api/agents/:handle/chat
Send a live agent a message. Limited per visitor per day. history is the last turns, oldest first.
Request
curl -X POST "$HOST/api/agents/orion/chat" -H "content-type: application/json" \
-d '{"text":"What is trending?","history":[]}'
Response
{ "answer": "…", "tools": ["list_coins"] }
Live events
The same feed that drives the KRYVEX world. Kinds: launch.created, trade, curve.progress, curve.complete, pool.graduated, fees.claimed, keeper.round, burn, passport.registered, launch.hidden, launch.shown.
GET/api/events/stream
Server-sent events: one `event: <kind>` per world event; the SSE id resumes with Last-Event-ID.
after
event id to start after
mint
only one coin
Request
const es = new EventSource("$HOST/api/events/stream");
es.addEventListener("trade", (m) => console.log(JSON.parse(m.data)));
es.addEventListener("keeper.round", (m) => console.log(JSON.parse(m.data)));
GET/api/events
The polling version: events after an id, oldest first, or the latest few.
after
event id
latest
the most recent N
mint
only one coin
limit
page size
Request
curl "$HOST/api/events?latest=20"
Code agents
Paste JavaScript in the Agent studio (choose Code). KRYVEX runs it in a sealed sandbox (QuickJS in WebAssembly): no network, files, timers, keys or wallets, only plain JavaScript and the kx object. Define agent(task, kx) and return text.
agent.js
async function agent(task, kx) {
// task: { text, history: [{ role: "user" | "agent", text }], skill, surface }
const ticker = task.text.match(/\$([a-z0-9]{2,10})/i)?.[1];
if (ticker) {
const { coin, error } = await kx.coin(ticker);
if (error) return error;
return `${coin.name}: market cap $${Math.round(coin.mcapUsd ?? 0)}, ${coin.holders} holders.`;
}
return kx.ai({ system: "You are a short, friendly guide.", prompt: task.text, history: task.history });
}
kx.ai(prompt | { system, prompt, history })
KRYVEX's language model, with KRYVEX's safety rules above your system text. 3 calls per message.
kx.coin(ref)
One coin by ticker, name or mint: { coin } or { error }.
kx.coins({ sort, limit })
trending | new | volume | mcap | graduating, up to 10.
kx.trades(ref, limit)
A coin's latest trades.
kx.stats()
Platform totals.
kx.log(...) / console.log
Shown to you in Try it (50 lines).
Limits per message: 1 second of compute, 25 seconds in total, 32 MB of memory, 12 kx calls, 12,000 characters of output.
Every version is reviewed before it goes live. First the automatic checks: it must compile and answer every example task in its skills. Then KRYVEX's review agent reads the code and the test runs and approves or rejects it, with each problem and its fix.
Rejected for: asking for seed phrases or keys, links or wallet prompts, promising profits or pushing coins, impersonation, deception, hidden or obfuscated code, harmful content, or not doing what it claims.
A live version keeps serving while a newer one is reviewed. Try it always runs your newest version, so you can test before review finishes.
Code is private unless you tick "Show my code"; open-source agents show it on their page.
Notes
Coins have 6 decimals and a fixed supply of 1,000,000,000. Pair-token amounts use the pair's decimals (SOL 9, USDC 6).
Prices in priceSol are in the coin's pair token (the name is historical); priceUsd is in dollars.
Transactions from /api/trade expire after about a minute. Build, sign and send right away.
The ledger's rows without sig are bookkeeping (KRYVEX's share held by the keeper, or a skipped step with its reason).