Launch API

Authentication

Every request carries an API key in the Authorization header. A key belongs to one wallet and acts as it: launches you create with it are launched from that wallet, and only that wallet's launches are visible to it.

Create keys at API keys after signing in with the wallet. A key is shown once — we store only its hash — and can be revoked at any time. Up to 5 active keys per wallet.

Keep keys server-side. A key cannot move funds, but it can create launches for its wallet.

Upload an image

POST/images

Stores a coin logo and returns its URL — the only kind of URL imageUrl accepts when you create a launch. Send multipart/form-data with one file field named image: PNG, JPEG or WebP, up to 5 MB. The type is read from the file's bytes, not its name or Content-Type. The same picture always gets the same URL.

Rate limit: 20 per 10 minutes per key

Body

imagefilerequired

The logo (multipart/form-data). PNG, JPEG or WebP, up to 5 MB.

Returns

• 201 Stored. Pass url as imageUrl when you create the launch.

Errors

• 400 No image file, an empty file, or a file that is not PNG, JPEG or WebP.
• 413 The file is over 5 MB.
• 503 Image upload is not available on this server.

Create a launch

POST/launches

Registers a coin to launch from the key's wallet. Nothing happens on chain yet: next, fetch the transaction and sign it. The launching wallet is always the key's wallet — there is no wallet field to set.

Rate limit: 10 per 10 minutes per key

Body

symbolstringrequired

Ticker: letters and digits, 1–10 characters (pons' rule). Upper-cased; a leading $ is dropped.

namestringrequired

Coin name: letters, digits and single spaces, 1–32 characters (pons' rule).

pitchstringrequired

Description shown on pons, 1–256 characters. **No links** of any kind — pons rejects them.

creatorTaxBpsintegerrequired

Launcher tax in basis points, 0–1000 (0–10%). All of it is paid to the launching wallet. See Fees.

pairedAssetstringoptional

What the coin trades against, by symbol: ETH, USDG, or any of pons' pair assets — stock tokens like TSLA, NVDA, SPY, and cbBTC, TAO (70 in all). Default ETH.

xHandlestringoptional

X profile: an x.com/<handle> (or twitter.com) profile URL, or the bare handle / @handle. Up to 15 letters, digits or _. Post URLs (/status/…) are rejected.

telegramstringoptional

A t.me/<name> URL of a public group or channel (5–32 letters, digits or _); bare usernames, invite links (t.me/+…, t.me/joinchat/…) and message links are rejected. Stored as https://t.me/<name>, the way pons puts it on chain.

imageUrlstringoptional

Logo. Must be a url returned by Upload an image (POST /images) — any other URL, including an image hosted elsewhere, is rejected with 400. The URL goes on chain for good.

detailsobjectoptional

Optional notes, read by Jev as part of the launch package (what a name and pitch cannot say) — not on chain, shown on Jevvis as plain text. Keys (all optional): origin, lore, timing, ecosystem, tech — originality, backstory, the current event, ecosystem (team, partners, backers), tech or product. How easy the joke is and who is already talking about it are read from the launcher's last 50 X posts instead; the old keys meme and attention are rejected with 400. Each a string, trimmed, at most 600 characters (UTF-16 code units, like pitch); an empty one is dropped. An unknown key, a non-string value or a control character (other than newline / tab) rejects the whole launch with 400.

judgesstring[]optional

Paid naming: creator module ids from List creators, any number of them (all listed creators if you like). Each costs one unitPriceMinor; the total is held from the key wallet's prepaid balance now, and whatever creators who cannot answer would have cost is refunded after judging. Requires group.

groupobjectoptional

Required with judges: { name, filters } — the push group, set up like a subscriber's group. name 1–40 characters; filters { match: "strict" | "standard" | "loose", minPass: 1–500, weights: { core, persona, tweet_style, coin_style } } — each named creator is compared with the coin question by question, the four cards weighted by weights (integers 0–100 adding up to exactly 100; anything else is a 400 that says what is wrong), and the coin is sent to every Jevvis user as a notification when at least minPass of them pass the match tier (see Thresholds). Omitted: loose, 1, 5 / 15 / 30 / 50. **Deprecated**, still accepted and converted when match is absent (see the table under Thresholds): lean, tier, minBull, minAnswered. The group also appears on your subscriber page, switched off.

Returns

• 201 Created. Keep id.

Errors

• 400 A field is missing or out of range, a judges id is not a listed creator, or judges came without group. The message names the field.
• 402 The prepaid balance cannot cover judges × unitPriceMinor. Nothing was created.
• 503 The API is not configured.

Get the launch transaction

GET/launches/{id}/transaction

Returns the unsigned transaction(s) the launching wallet signs and sends itself — we never hold a key. Send approve first when it is not null (any pair other than ETH, when the allowance is short) and wait for it to be mined, then send tx. The pons launch fee and pricing are read from chain when you call this, so build right before you sign.

Rate limit: 20 per 10 minutes per key

Path parameters

idstringrequired

The launch id returned by Create a launch (launch:…). The bare part after launch: works too.

Query parameters

devBuystring (integer)required

The first buy, in the paired asset's smallest unit: wei for ETH, 10⁻⁶ for USDG, 10⁻¹⁸ for stock tokens (the pair's own decimals). pons requires at least 1.

Returns

• 200 value and amounts are decimal strings in wei / smallest units.

Errors

• 400 devBuy is missing, not an integer, or 0.
• 404 No such launch for this key's wallet.
• 409 Already launched, or the launch's paired asset is no longer supported.
• 502 Reading pons from chain failed. Retry.
• 503 The launch contract is not live yet.

Confirm a launch

POST/launches/{id}/confirm

Hand back the hash of the launch transaction you sent. It is verified on chain immediately — no waiting for an indexer. 202 means the transaction is not mined yet: call again in about 3 seconds. The hash only tells us where to look; every check reads chain data (it went through our launch contract, from this launch's wallet, with its tax).

Rate limit: 30 per minute per key

Path parameters

idstringrequired

The launch id returned by Create a launch (launch:…). The bare part after launch: works too.

Body

txstringrequired

The launch transaction hash, 0x + 64 hex characters.

Returns

• 200 Launched and verified.
• 202 Not mined yet. Retry in ~3 s.
• 200 The transaction reverted. Nothing launched; build and send again.
• 200 Mined, but it is not this launch. problem is display text naming the check that failed (see Launch object → mismatch).

Errors

• 400 tx is not a transaction hash.
• 404 No such launch for this key's wallet.
• 502 Reading the receipt failed. Retry.
• 503 The launch contract is not live yet.

Retrieve a launch

GET/launches/{id}

One of the key's launches with its current status. Also finds launches confirmed later by our chain watcher, e.g. if your program stopped before confirming.

Rate limit: 60 per minute per key

Path parameters

idstringrequired

The launch id returned by Create a launch (launch:…). The bare part after launch: works too.

Returns

• 200 The launch object.

Errors

• 404 No such launch for this key's wallet.

List your launches

GET/launches

Every launch created from the key's wallet, newest first — including ones not launched yet and why a mismatch was rejected.

Rate limit: 60 per minute per key

Returns

• 200 OK.

List creators

GET/creators

The creator modules a launch may name in judges, and the price per named creator (unitPriceMinor, in 10⁻⁶ USD). freeMax is 0: every named creator is paid. creator is the creator's current X handle for display — null while it is not known yet; name creators by module id, never by handle. compare says whether the creator can be compared at all (see Thresholds): spec is the question set it was counted against, cards how many questions each card has a number for — core, persona, tweet_style, coin_style — null for a card with too few posts (every coin reads can't tell there). compare is null for a module not yet recomputed into a comparison profile. The creator's own numbers and the per-question verdicts are on each coin's page, for those who may see that creator. origin is official for a module Jevvis made from its own research, self for one the creator made; sourceRunId is the X analysis it was built from (null if none); cardRules is the version of the card-to-module rules it was built under (null when it was not built from a card; the current version is 5; a lower one is being rebuilt from its source analysis under the current rules — there is one set of rules, not two).

Rate limit: 60 per minute per key

Returns

• 200 OK.

Confirm a group's threshold

POST/groups/{id}/confirm-match

A group saved before the three-tier threshold existed was converted from its old lean / minBull (see Thresholds) and is marked matchNotice: true until its owner confirms. This confirms it: the converted match and minPass are written into its filters and matchNotice turns false. Same as the Confirm button on the subscriber page. The group id is data.groupId in a webhook event. Only the key wallet's own groups.

Rate limit: 10 per 10 minutes per key

Path parameters

idstringrequired

The group id.

Returns

• 200 The group as saved.

Errors

• 404 No such group for this key's wallet.

Webhooks

Instead of polling, register a URL and we push each new notification to it the moment it exists: one per coin and group when creators in one of your groups judge a new launch (with what that group was charged and whether it passed the group's filters), and a broadcast when a launcher's paid push goes out to every user. If a coin is charged again later, you getnotification.updated for the same notification. Each delivery is a POST with a JSON body, signed with the secret you got when registering.

Event attributes

idstringrequired

ntf_ + the notification id; an update is ntf_<id>_r<n>. The same event can arrive more than once (a retry after your endpoint timed out); use this to ignore repeats.

typestringrequired

notification.created the first time. notification.updated when a notification you already got changed — a coin is often charged in two batches, so the amount (and the group's read) can grow; the new version carries the same data.id and replaces the old one.

data.idintegerrequired

The notification. One per coin × group: an update reuses it.

data.kindstringrequired

group: creators in one of your own groups judged the coin (one notification per coin × group). launch: a broadcast — a launcher paid a group of creators to judge it, and the result is pushed to every user. charge: only in notifications from before 2026-09-27 (one per charge).

data.proactivebooleanrequired

true for a broadcast (kind: launch): you did not subscribe to anything to get it. data.groupName is the launcher's group that judged it.

data.chargedMinorinteger | nullrequired

group: what this group's card spent on this coin, in millionths of a dollar (the group card's own figure; a creator you have in two groups is counted on both). null for a broadcast.

data.passedboolean | nullrequired

group: whether the coin passed that group's threshold (data.match). A coin that did not pass is still charged but is not sent here — it only shows under “Below threshold” on the notifications page; you get notification.updated with false only if one you already received stopped passing. null for a broadcast.

data.matchobject | nullrequired

The group's threshold result: tier (strict / standard / loose), minPass, weights (the group's four card weights), passCount (members who passed), compared (members with a comparison) and passed. Each member's result is data.coin.members[]: match.cards — per card matched, conflicted, unknown, bothAbsent, total, similarity (see Thresholds) — overall { coverage, similarity } with the group's weights (similarity null when coverage is short), and passes; match null = no comparison profile yet. total, match, conflict, unknown, redline are **deprecated** F016 fields kept for older receivers: the four cards added up, redline always 0. A notification from before the four cards carries only those deprecated fields. null for a broadcast from before the threshold existed.

data.coin.judged, data.coin.countsinteger, objectrequired

How many of the group's creators judged it (judged), and how many leaned bullish / neutral / bearish (counts — **Deprecated** (derived from the old bullish score pBuy): still sent, removed once every creator module has been recomputed. Use match.). A snapshot at the moment it was judged.

data.coin.score, data.coin.supportnumber | nullrequired

score: the weighted mean stance (pBuy) of the creators who could answer — one vote each at least, more for more subscribers. support: the mean evidence support of those readings. null when nobody could answer. **Deprecated** (derived from the old bullish score pBuy): still sent, removed once every creator module has been recomputed. Use match.

data.coin.membersarrayrequired

The creators behind the counts: moduleId, creator (display handle or null), match, overall and passes (see data.match), and the deprecated pBuy (null = no reading; 0 = a veto) and lean. A broadcast lists only the creators you can see (you subscribe to them); the counts still include everyone.

data.imageUrlstring | nullrequired

The coin's launch image, or null.

data.urlstringrequired

The coin's analysis page.

• Answer any 2xx within 10 seconds. Anything else — another status, a timeout, a redirect — is a failure. Redirects are not followed.
• A failed delivery is retried after 30 s, 2 min, 10 min, 1 h and 6 h, then given up.
• After 20 failures in a row the webhook is switched off; re-enable it once your endpoint works.
• Verify the signature on the raw body before parsing it, and reject a t more than 5 minutes old.

Register a webhook

POST/webhooks

Every new notification of the key's wallet — its own groups' reads and launch pushes to every user — is POSTed to this URL as it happens, signed. Only notifications after registering are sent. Keep the returned secret: it is shown once, and it is how you verify each delivery (see Webhooks).

Rate limit: 10 per 10 minutes per key

Body

urlstringrequired

An https URL on port 443 of a public host, up to 500 characters. Up to 3 per wallet. Private, loopback and link-local addresses are refused — also when the host later resolves to one.

Returns

• 201 Store secret now; it is never shown again.

Errors

• 400 url is not an https URL on 443 of a public host.
• 409 The wallet already has 3 webhooks. Delete one first.

List webhooks

GET/webhooks

The key wallet's webhooks with their last 20 deliveries. A webhook switched off after repeated failures has disabledMs and the reason.

Rate limit: 60 per minute per key

Returns

• 200 secret is never listed.

Delete a webhook

DELETE/webhooks/{id}

Stops pushing to that URL. Deliveries still waiting to be retried are dropped.

Rate limit: 10 per 10 minutes per key

Path parameters

idstringrequired

The webhook id (wh_…).

Returns

• 200 OK.

Errors

• 404 No such webhook for this key's wallet.

Re-enable a webhook

POST/webhooks/{id}/enable

A webhook is switched off after 20 failed deliveries in a row. Fix your endpoint, then call this: pushing resumes from new notifications (the ones missed while it was off are not replayed; they are still in the inbox).

Rate limit: 10 per 10 minutes per key

Path parameters

idstringrequired

The webhook id (wh_…).

Returns

• 200 OK.

Errors

• 404 No such webhook for this key's wallet.

Errors

Errors use conventional HTTP status codes and one body shape. Branch on error.code; error.message is for people and may change (some messages are in Chinese).

Rate limits

Limits are sliding windows. Every response carries the current state; over the limit you get 429 withRetry-After in seconds. Requests are not queued — wait and retry.

Transaction and confirm calls read a shared chain node, so they also share a service-wide cap; you may see a 429 before your own limit when it is busy.