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 large

The 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 purchase

POST/api/purchases/:id/githubbuyer, paid

{ "username": "octocat" }
→ 200 { "ok": true, "repo": "owner/name" } · 400 bad username · 409 tied to another account · 502 GitHub refused

Ownership#

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 taken

The 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 minutes

PUT/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 frozen

Reads 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 on

Prism 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 yet

The 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 on

Puts 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 on

redirect 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 used

Fee 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 set

Runs 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 lnk
NextRunning it yourself →