Developers
API reference
Every route: inputs, outputs, status codes.
Base URL https://everynth.org. Requests and responses are JSON unless noted. Routes marked session need the cookie set by POST /api/session; the browser sends it automatically. Errors are { "error": "message" } with a 4xx status.
Session#
POST/api/sessionpublic
Sign in with a wallet signature.
{ "wallet": "<base58>", "issuedAt": 1758445200000, "signature": "<base64 ed25519 over the login message>" }
→ 200 { "wallet": "<base58>" } + Set-Cookie everynth_session (httpOnly, 7 days)
→ 400 missing fields · 401 invalid or expired signature (5-minute window, host-bound)The message to sign, byte for byte:
${host} wants you to sign in to EVERYNTH.\nThis is free and does not move any funds.\n\nWallet: ${wallet}\nIssued at: ${issuedAt}DELETE/api/sessionsession
Sign out. Clears the cookie. → 200 { "ok": true }
Rate limits#
Counted per wallet (per IP when there is no session), in fixed windows, in the database — so every serverless instance counts into the same bucket. Over budget returns 429 with a retry-afterheader. Nothing here is near what normal use looks like.
POST /api/session 30 / 10 min
POST /api/products 25 / hour
POST /api/upload 20 / hour
POST /api/orders 40 / hour
POST /api/purchases/:id/review 20 / hour
POST /api/reports 10 / hour
GET /api/verify 300 / minute (per IP)
GET /api/launches/:id/gate 300 / minute (per IP)
POST /api/launches 10 / hour (frozen launches per wallet)
POST /api/launches/:id/launch 30 / hour (verifications; retrying while the RPC catches up is normal)
POST /api/agents/sessions* 40 / hour (studio messages, on top of the daily session quota)
POST /api/launches/:id/desk 40 / hour (shares the studio bucket)
POST /api/launches/:id/identity 40 / hour (shares the studio bucket)Products#
POST/api/uploadsession
Token exchange for a direct browser upload to blob storage (Vercel Blob client protocol). Use upload() from @vercel/blob/client with handleUploadUrl: "/api/upload". Only application/octet-stream up to 200 MB + 28 bytes is accepted.
POST/api/productssession
Launch a product. multipart/form-data:
title 3–80 chars description 10–4000 chars
category AI Agent | API | Dataset | Tool | Research | Service | Community
price "0.02" … "1000000", ≤ 9 decimals (SOL)
kind file | secret | github
cover image/png|jpeg|webp|gif ≤ 1 MB (optional)
issuedAt ms timestamp, ≤ 5 min old
signature base64 ed25519 over the launch message, by the session wallet
kind=file key (base64, 32 bytes) fileName fileType payloadUrl (our blob host only)
kind=secret key (base64, 32 bytes) payload (Blob: iv‖ciphertext, ≤ 64 KB + 28)
kind=github repo ("owner/name") token (checked live: must have admin on the repo)
→ 200 { "id": "<uuid>" } · 400 validation · 401 bad confirmation · 403 wallet blocked · 413 too largeThe launch message, rebuilt server-side from the submitted title, price (in lamports) and kind:
${host} wants you to confirm this launch on EVERYNTH.\nThis is free and does not move any funds.\n\nTitle: ${title}\nPrice: ${lamports} lamports\nDelivery: ${kind}\nCreator: ${wallet}\nIssued at: ${issuedAt}PATCH/api/products/:idcreator + signature
Edit listing details: title description category price cover (same rules), plus issuedAt and signature. Content is immutable. → 200 { ok } · 401 bad confirmation · 404 not yours.
${host} wants you to confirm: edit listing.\nThis is free and does not move any funds.\n\nItem: ${id}\nTitle: ${title}\nPrice: ${lamports} lamports\nWallet: ${wallet}\nIssued at: ${issuedAt}POST/api/products/:id/removecreator or admin + signature
Unlist. Body: { "block": true } (admins) also blocks the creator and unlists all their products, plus issuedAt and signature. → 200 { ok } · 401 bad confirmation
${host} wants you to confirm: remove from market.\nThis is free and does not move any funds.\n\nItem: ${id}\nScope: product | product and creator\nWallet: ${wallet}\nIssued at: ${issuedAt}POST/api/purchases/:id/reviewbuyer
Review a product you paid for. One review per purchase; posting again rewrites it. { "rating": 1-5, "body": "≤ 500 chars" } → 200 { ok } · 400 bad rating or too long · 404 no paid purchase of yours.
GET/api/products/:id/coverpublic
The cover image bytes, or 404. Cached 5 minutes.
Orders and purchases#
POST/api/orderssession
{ "productId": "<uuid>" }
→ 200 { "purchaseId", "reference", "creator", "creatorAmount", "treasury", "fee" } // lamports
→ 400 own product · 404 not live · 409 already owned (also after chain recovery)Reuses the caller's open order for the product if one exists, after checking the chain for a payment.
POST/api/orders/:id/confirmbuyer
{ "signature": "<base58>" } // optional: without it the server searches by reference
→ 200 { "ok": true } · 402 { "error": "payment not found yet" | "underpaid: …" | "transaction failed on-chain" | … }GET/api/purchases/:id/contentbuyer, paid
file { "kind": "file", "fileName", "fileType", "key": "<base64>", "payloadUrl": "https://…blob…", "payload": null }
secret { "kind": "secret", "key": "<base64>", "payload": "<base64 iv‖ciphertext>", "payloadUrl": null }
github { "kind": "github", "repo": "owner/name", "githubUser": "octocat" | null }
→ 404 no paid purchasePOST/api/purchases/:id/githubbuyer, paid
{ "username": "octocat" }
→ 200 { "ok": true, "repo": "owner/name" } · 400 bad username · 409 tied to another account · 502 GitHub refusedOwnership#
GET/api/verify?product=&wallet=public · CORS *
→ 200 { "owned": boolean, "since": ISO date | null }. See Ownership check.
Launchpad#
POST/api/launchessession + signature
Freeze a token launch. The caller must own the utility (built or bought). Body:
{
"productId": "<uuid>", "name": "3–40 chars", "ticker": "2–10 A–Z0–9", "supply": "1000000000",
"project": { "pair": "evyn" | "sol", "fee": 0, "slug": "a-z0-9-", "description": "10–4000", "theme": "", "color": "#rrggbb",
"template": "basic" | "glow" | "brutal", // the landing page's look
"website": "", "x": "", "telegram": "", "github": "", "utilityUrl": "" },
"stack": ["antisnipe", "buyback", "burn"], // mechanic ids, in run order, ≤ 80% of a round in total
"devBuy": "0.05", // SOL, 0–50
"gateBalance": "10000", "gateUnlocks": "what opens",
"issuedAt": <ms>, "signature": "<base64 ed25519 over the 'launch token' action message>"
}
→ 200 { "id", "slug" } · 400 a step's rule · 401 bad confirmation · 403 blocked · 409 permalink takenThe signed lines are listed on Launching a token.
GET/api/launches/:id/chat?after=public
The coin's community room, oldest first: the latest 80 messages, or only those newer than after (a message id). → 200 { "messages": [ { id, wallet, role: "dev" | "holder", held, body, created_at } ] } — held is the coin in base units at the moment of writing.
POST/api/launches/:id/chatsession · holds the coin, or launched it
{ "body": "1–500 chars", "replyTo": "<message id in this room>" (optional) }
→ 200 { "message" } · 401 sign in · 403 holds none of the coin · 409 not on the curve yet · 429 more than 20 per 10 minutesPUT/api/launches/:id/chat/pinsession · the launcher
Pin one message to the top of the room, or clear it. { "id": "<message id>" | null } → 200 { "pinned": message | null } · 403 not the launcher · 400 not in this room.
GET/api/launches/:id/roundspublic · CORS *
Every fee round the vault ran for the coin, oldest first, as CSV (text/csv): time, quote, swept, EVYN burned, launcher, buyback, the coin burned, to holders, lottery, revshare, held — in whole SOL or EVYN.
GET/api/launchpad/devbuy?pair=&sol=public
What a dev buy of sol gets on a fresh curve of that pair, priced with the Pump SDK. → 200 { "pair", "sol", "quoteIn", "tokens", "pct" } · 400 out of range · 502 the RPC did not answer.
GET/api/launches/slug?slug=public
Is a permalink free? → 200 { "slug", "taken": boolean } · 400 not a valid slug. The launch flow asks as you type; the freeze checks again.
GET/api/launchessession
The caller's own launches. → 200 { "launches": [ { id, slug, name, ticker, status, mint, pair, … } ] }
POST/api/launches/:id/launchowner
{ "signature": "<base58 of the create transaction>", "mint": "<base58>" }
→ 200 { "ok": true, "mint", "status": "launched" }
→ 400 junk · 402 not on chain yet / not paid by you / creator is not the vault / wrong supply or quote · 404 not yours · 409 not frozenReads the curve from the chain and marks the launch launched. Safe to retry while the transaction confirms.
GET/api/launches/:id/metadatapublic
The coin's metadata JSON (name, symbol, description, image) that the mint's URI points at.
GET/api/launches/:id/logopublic
The coin's image, always PNG 512×512 (pump.fun shows no SVG): the launcher's upload or Prism's drawing, else the utility's cover, else the initial on the project colour.
PUT/api/launches/:id/logoowner
Multipart file (PNG, JPEG, WebP or GIF, under 2 MB), cropped to 512×512. → 200 { "ok": true, "source": "upload" } · 413 · 415. Set it before the create: pump.fun keeps the first image it sees.
POST/api/launches/:id/identityowner
→ 200 { "logo": boolean, "banner": boolean } // what Prism drew this time
→ 401 · 404 not yours · 409 SOL pair · 429 · 503 the desk is not switched onPrism draws the logo (skipped when you uploaded one) and the 3:1 banner as SVG, rendered to PNG. Allowed before launch; about a minute.
GET/api/launches/:id/bannerpublic
The banner PNG 1500×500, or 404 until Prism has drawn one.
GET/api/launches/:id/gate?wallet=public · CORS *
→ 200 { "mint", "wallet", "balance": "<base units>", "needed": "<base units>", "unlocked": boolean, "unlocks": "…" }
→ 400 wallet is required · 404 · 409 not launched yetThe holder gate, answered from the chain. Prove the wallet first, as with the ownership check.
POST/api/launches/:id/deskowner
→ 200 { "deliverables": [ { "kind": "identity" | "narrative" | "site", "agent", "model", "output", "created_at" } ] }
→ 401 · 404 not yours · 409 SOL pair, or not launched yet · 429 · 503 the desk is not switched onPuts the desk to work on an EVYN-paired, launched coin; about a minute. Running again overwrites.
Studio#
POST/api/agents/sessionssession + EVYN gate
{ "agent": "creative" | "copywriter" | "narrator" | "social" | "analyst", "message": "1–4000 chars",
"image": "data:image/png;base64,…" } // optional: PNG, JPEG, WebP or GIF under 4 MB, shown to the agent for this turn only
→ 200 { "session": { "id", "agent", "turns", "messages": [ { "role", "content" } ], "created_at" }, "redirect": "<agent id>" | null }
→ 401 sign in · 402 { error, held, needed } below the gate · 400 unknown agent / bad message
→ 429 three sessions already open in the last 24 hours, or the hourly brake · 503 not switched onredirect is set when the agent declined because the question belongs to another agent; the reply names it.
POST/api/agents/sessions/:idsession + EVYN gate, own session
{ "message": "1–4000 chars", "image": "data:image/…;base64,…" (optional) }
→ 200 same shape · 404 no such session · 409 the session's 12 turns are usedFee rounds#
GET/api/cron/feesCRON_SECRET
Authorization: Bearer <CRON_SECRET> (or ?key=<CRON_SECRET>)
→ 200 { "ok": true, "rounds": [ { launch, ticker, mint, pair, quote, swept, burnedQuote, launcher, buyback, burned, holders, revshare, lottery, held, txs, graduated, note? } ] }
→ 401 · 503 VAULT_SECRET is not setRuns one fee round over every launched coin. Vercel's cron calls it daily; the repository's fee rounds workflow every 15 minutes.
Moderation#
POST/api/reportssession
{ "productId", "reason" } (5–1000 chars). One per wallet per product. → 200 { ok }
POST/api/admin/unblockadmin
{ "wallet" } → 200 { ok }. Admins are the wallets listed in ADMIN_WALLETS.
Limits at a glance#
price 0.02 – 1,000,000 SOL fee 5%, floor(lamports × 500 / 10000)
file ≤ 200 MB secret ≤ 64 KB cover ≤ 1 MB
login signature valid 5 min session 7 days
blocked ext exe msi bat cmd com scr pif vbs vbe ps1 dll dmg pkg app apk deb rpm jar lnkNext