# Jevvis

> JEVVIS.OS reads the situation you are actually in and hands back analysis and advice while they still matter.

Read the reality, then act

- **Jevvis X** (https://jevvis.app/x): Point it at your X account. It reads your posts, works out what kind of account you are and deals you cards — your twin starts here.
- **Jevvis Alpha** (https://jevvis.app/alpha): New coins, judged by creators' twins the moment they launch. Subscribe to the creators you trust, or launch a coin into the stream. Jevvis sits between every role: creators' twins judge each new coin launched through it, and every payment on the platform is for those reads.

A creator's "twin" is their judging module: built from a Jevvis X analysis of their own account with the coin-picking module, it scores every new coin launched through Jevvis.

This is the production build (https://jevvis.app). Jevvis Alpha runs on Robinhood Chain (chain id 4663).
Sign-in: X (Twitter) for analyses and creators; a wallet signature (free, no transaction) for subscribers, launchers and API keys.

## Architecture

Jev is the underlying model: it returns typed, calibrated judgments with a probability. Jevvis is the platform built on it. The home page draws it as five layers, top to bottom, in these words (the component names are capabilities, part of what the platform is growing into, not a list of finished services):

**The Commander Architecture** — Five layers, from the decision you need down to who pays for the work. Each layer answers the one above it.

- **Application Layer** — The decisions the platform is actually used to make, and the form they reach a person in. States what is being asked, and turns what comes back into something somebody can act on.
  - Marketing advice · Company decision · Audience insight · Report & share
- **Data Layer** — Takes raw material in, turns it into signal, then gives that signal names and groups. Feeds labelled, segmented material to the layers below, and never pays twice for the same input.
  - Data input · Signal processing · Labelling · Segmentation
- **Analysis Layer** — Measures whether the answers are any good, and keeps measuring as the ground moves. Scores the layer below against evidence, and feeds what it finds back into how the question gets asked.
  - Measurement · Quality loop · Aggregation · Benchmark
- **AI Layer** — Makes the judgments: Jevvis where the answer must be typed and calibrated, an LLM where language has to be written. Answers what the data layer sends, and hands each answer up to be measured rather than trusted.
  - Jevvis · LLM · Question design · Probability & confidence
- **Economy Layer** — Who gets paid, who pays, and what a piece of work costs to run. Prices what the application layer asked for, settles it, and reports the real cost back as the price of that answer.
  - Creators · Credits · Payments · Pricing

## Roles

- **Visitor** (no sign-in): reads the public pages — home, https://jevvis.app/x, https://jevvis.app/alpha, coin pages, shared cards, docs.
- **X-login user**: analyses their own X account (see /x under Pages); a paid run (1 USDG) is paid in USDG on Robinhood Chain from a signed-in wallet.
- **Subscriber** (wallet sign-in): prepaid USDG balance, subscribes to creators through groups, gets notified (see /alpha/subscriber under Pages and /alpha/notifications).
- **Creator** (X sign-in): turns their analysis into a judging module and earns 50% of every charge on its reads (see /alpha/creator under Pages).
- **Launcher** (wallet sign-in): launches a coin on pons through Jevvis from their own wallet and claims its trading fees (see /launch under Pages and /alpha/launcher).
- **Trader**: trades a launched coin on pons (on chain, not on this site); the coin page links to it and to the explorer.
- **API user**: launches from code with an API key (see /user/keys under Pages, and the API section).

## Pages

### Home — https://jevvis.app/

Buttons "Jevvis X" and "Jevvis Alpha"; a desktop of small windows (what Jevvis is, how it works, a sample run, stats: members, analyses, per-judgment price, free seats left); the product cards.
1. Press "Jevvis X" to analyse an X account, or "Jevvis Alpha" for the coin market.
Who sees what: Everyone; nothing personal.

### Jevvis X — analyse your X account — https://jevvis.app/x

Price facts (free run: 10 posts, once; full analysis: 1,000 posts, 1 USDG; free seats); the four analysis cards every run produces (base profile, personality, posting, coin picking — nothing to pick) with a line saying which of the three this run is; "My cards" (your finished cards, flip for evidence, "Load more"); "Analysis Jevvis made for you" when Jevvis analysed your account in its research.
1. Press "Start analysis · Free" (or "· <price>"); sign in with X when asked. The target is always your own account.
2. Paid: sign in with a wallet, then "Pay <amount>" (USDG transfer) or paste a transaction hash and "Check". The run starts once the transfer confirms.
3. The card appears in "My cards"; "View full report →" opens /runs/{id}.
Who sees what: Anyone sees the four cards; signed out, "My cards" shows a sample card. Your own cards need X sign-in; "Analysis Jevvis made for you" is shown only to that account.

### Analysis report — https://jevvis.app/runs/{id}

The card (zoomable), "Copy image" / "Share on X" (a PNG per module), "As a creator module" (the weights this analysis gives as a module), and the "Analysis report": account facts, scope, template results, distributions. Progress shows while it runs; leaving does not stop it.
1. Open it from "My cards"; wait for the run to finish; share the image if you like.
Who sees what: Only the X account that ran it (others get not-found; signed-out visitors are sent to /login).

### Shared card — https://jevvis.app/c/{shareId}

One shared card, zoomable, with "Read my own account" leading to /x.
1. Open the link; flip the card; press "Read my own account" to run your own.
Who sees what: Public: the link is the only key.

### Jevvis Alpha market — https://jevvis.app/alpha

A demo reel (illustrative numbers), the money-flow map (who pays whom, live prices), "TOP CREATORS" by USDG earned, and "Launched through Jevvis" (coins that passed the launch check). Tabs: Subscriber, Creator, Launcher, Notifications, Launch.
1. Tap a role on the money-flow map to see what it gives and gets; open a coin for its analysis page.
Who sees what: Public; creators appear by handle, earnings and subscriber count only.

### Subscriber — https://jevvis.app/alpha/subscriber

"Subscriber settings": Balance, This month, Spent in total, Active subscriptions; "My subscription groups" (cards with On/Paused, members, spend); "Subscribed" table; "Group spending" log.
1. Sign in: connect a browser wallet and press "Sign in with {address}" — a free signature, no transaction. No X account needed.
2. Top up: press "Top up", pick an amount ($0.10–$10,000.00), press "Send <amount> USDG"; your wallet sends a USDG transfer on Robinhood Chain to the treasury; credited after 3 confirmations.
3. Subscribe: press + (New group), name it, tick creators, set "When to notify you" — "Card weights" (four linked sliders, one per card: Base profile, Personality, Posting, Coin picking; whole numbers 0–100 that always add up to 100 — moving one makes the other three give or take in proportion), "Each creator's threshold" (Strict / Standard / Loose) and "At least this many creators pass" — press "Save". Newly ticked creators start billing ($0.001 per coin each); unticked ones in no other group are unsubscribed.
4. A group saved before the three thresholds shows "The threshold moved to the new rules: …. It was converted from your old settings — please confirm."; press "Confirm".
5. Switch a group On/Paused, "Edit" or "Delete group" at any time.
Who sees what: Only the signed-in wallet's own balance, groups and charges; signed out it shows only the sign-in box.

### Creator — https://jevvis.app/alpha/creator

"Creator settings" (Total earned, Claimable, Pending, Paid out, "Claim <amount>"), "Modules & optimisation" (each module with dimensions, weights, readable/influence), "Analytics & revenue", "Named in launches", "Earnings ledger", "Claims".
1. Sign in with X.
2. Press "＋ Create a module": the same four-card analysis opens, at 1,000 posts (a free seat if you have one, otherwise 1 USDG — never the 10-post free run, which cannot be listed); when the run finishes it becomes a module card, unlisted. Every earlier coin-picking analysis of your account is a module card too.
3. Name it ("Rename"), "List for subscribers" (or "Unlist"), or "Delete module".
4. To get paid: sign in with the wallet to be paid to, press "Claim <amount>". The operator pays it on chain to that wallet and marks it paid; the transaction shows under "Claims".
Who sees what: Signed out: a sign-in box only. Signed in: only your own modules and earnings.

### Launcher — https://jevvis.app/alpha/launcher

"Claimable and claimed" totals; "Your coins" (Coin, Launched, Fees generated, Yours, "Claim"), read live from each coin's fee splitter; "My submissions" (status, launcher tax, on chain, analysis).
1. Sign in: connect a browser wallet and press "Sign in with {address}" — a free signature, no transaction, with the wallet you launched from.
2. Press "Claim" on a coin and confirm the transaction in your wallet: the splitter pays the launcher and the ecosystem their shares. Whoever sends it pays the gas; the fees always go to the launch wallet.
Who sees what: Only the signed-in wallet's own coins and submissions.

### Notifications — https://jevvis.app/alpha/notifications

"Group notifications": one row per coin × group (Coin, Group, Match: how many of the group's creators passed its threshold; charged) plus "Broadcast" rows for paid launch pushes. Coins that missed the threshold sit under "Below threshold (n)", each saying what fell short. "Filter by group", "Mark all read", "Manage groups".
1. Sign in with your wallet; tap a row to open that group's reads on the coin, or "Open full page ↗".
Who sees what: Only the signed-in wallet's notifications; the same events can go to a webhook (/user/keys + API).

### Launch a coin — https://jevvis.app/launch

The form: Ticker, Name, Pitch, X profile, Telegram, Image (PNG/JPEG/WebP under 5 MB), Paired asset & first buy, Launcher tax (0–10%, with the per-trade split shown), and optional "Push to every user". Under the pitch, a folded "More about the coin (optional, not on chain)" block: 5 optional fields (Originality; Backstory; Current event; Ecosystem: team, partners, backers; Tech, product), up to 600 characters each; they are not put on chain. Jev reads the coin's name, ticker, pitch, these fields and the launcher's X bio and recent posts as one package, then each creator is compared question by question.
1. Sign in with the wallet you will launch from.
2. Fill the form. Optional: "Name creators" (any number of listed creators, $0.001 each, held from your prepaid balance, only those who answer are charged) — their combined read is pushed to every user if it passes the group's filters.
3. Press "Submit", then "Sign & launch" (a USDG pair asks to approve USDG first). The launch fee is read from chain and paid on top of the first buy.
4. It verifies on chain by itself: "Launched through Jevvis", or a message saying why it does not count. Fees and submissions are on the Launcher tab.
Who sees what: Anyone can open it; submitting needs the wallet sign-in.

### Coin analysis — https://jevvis.app/coin/{address}

The coin (pair, launcher tax, "Trade on pons ↗" when on mainnet, "Explorer ↗"), "The launcher on X (shown, not compared)" (likes, reposts, replies, quotes: mean and median; followers; how many posts were read or dropped), "Card weights" (the default, or one of your groups' weights — switching only recomputes the overall), one count line per creator who compared it (e.g. "Alike 14 · Unlike 4 · Can't tell 9 · Neither 11 (38 in all) · overall 78%"), and for creators you may see, one row each (Alike, Unlike, Can't tell, Neither, Total, Overall, Coverage, Group threshold) that opens into the four cards (Base profile, Personality, Posting, Coin picking) question by question: his number, the coin's answer, the verdict with its reason, his posts and what Jev read from the coin; "neither has it" and "not compared" are folded at the end. "How matching works →" explains the rules.
1. Open it from Alpha or a notification; press "Subscribe" on the locked block to go to the Subscriber page.
Who sees what: Visitors see the summary and how many creators judged it, not who. A signed-in subscriber sees the creators they paid for on this coin; a creator sees their own row.

### API keys — https://jevvis.app/user/keys

Your keys (Key prefix, Created, Last used, "Revoke") and "API docs →".
1. Sign in: connect a browser wallet and press "Sign in with {address}" — a free signature, no transaction, with the wallet your program launches from.
2. Enter a Name, press "Create key", copy it at once — it is not shown again.
Who sees what: Only the signed-in wallet's keys. A key acts as that wallet but cannot sign or move funds.

### API reference — https://jevvis.app/docs

Introduction, Authentication, Quickstart (JS / Python), Fees, every endpoint with parameters, examples and errors, the Launch object, Webhooks (payload, signature, verification code), Errors, Rate limits.
1. Read it top to bottom once; the quickstart runs the whole launch flow.
Who sees what: Public.

### How matching works — https://jevvis.app/methodology

How a coin is checked against each creator: an example (Sam and three coins), where the Y items come from, the three thresholds, red lines, personality guesses, evidence, what the four cards measure, the API fields, and the limits.
1. Read the example first; the details follow.
Who sees what: Public.

### Sign in with X — https://jevvis.app/login

One "Sign in with X" button and a language toggle.
1. Press "Sign in with X" and approve on X. Only the basic profile is read; nothing is posted and the X token is not stored.
Who sees what: Public.

### Terms — https://jevvis.app/terms

The terms of service.
Who sees what: Public.

### Privacy — https://jevvis.app/privacy

The privacy policy.
Who sees what: Public.

## What each launch field is for

Each field of the launch form (and of `POST /launches`) does one or more of three things: it goes on chain into pons, Jev reads it to compare the coin with each creator, or it is only shown. Only what is there at launch is read; editing your X profile later changes nothing already judged.

- **Ticker** (`symbol`), **Name** (`name`): on chain; read by Jev as the coin itself. Required.
- **Pitch** (`pitch`): on chain as pons' description (up to 256 characters, no links); read by Jev. Required.
- **X profile** (`xHandle`): on chain as the coin's X link. Jev reads that account's bio and its last 50 posts with the package: the questions about the launcher's voice and behaviour (personality, posting), how easy the joke is and who is already talking about it come from here. Its followers and likes / reposts / replies / quotes are shown on the coin page, not compared. Without it, those questions read can't tell (Coin C in the example under How matching works).
- **Telegram** (`telegram`): on chain as pons' Telegram link. Not read by Jev, not compared.
- **Image** (`imageUrl`): the logo, on chain, shown on pons and on Jevvis. Not read by Jev.
- **More about the coin (optional, not on chain)** (`details`): 5 optional notes, up to 600 characters each, not on chain, shown on Jevvis as plain text. Each feeds one coin-picking question that a name and pitch rarely answer:
  - Originality (`details.origin`) → “Original / first”. Creators who value originality and avoid copies read this.
  - Backstory (`details.lore`) → “Lore”. Creators who care about the story read this.
  - Current event (`details.timing`) → “Catalysts”. Creators who like coins riding a current event read this.
  - Ecosystem: team, partners, backers (`details.ecosystem`) → “Ecosystem”. Creators who care about team, partners and backers read this.
  - Tech, product (`details.tech`) → “Tech depth”. Creators who want real tech or a product read this.
  Left empty, Jev answers that question from the rest of the package, which often reads can't tell. Write facts Jev can check against the question (who, what, when), not slogans.
- **Paired asset** (`pairedAsset`), first buy (`devBuy`), launcher tax (`creatorTaxBps`): on chain; the tax is shown on the coin page and paid out through the fee split (see Fees). Not compared.
- Named creators and the push group (`judges`, `group`): who judges this coin at the launcher's cost and whether the result is pushed to every user. Not read by Jev.

## How matching works

Jevvis does not score a new coin or guess whether it will go up. The same Jev questions are asked of both sides: the creator's from his own posts, the coin's from its launch material read as one package, and then each question is compared. Every creator × coin pair stands alone; creators are not ranked against each other. An example first, then the rules; details come last.

### What the four cards measure

The comparison profile comes from the analysis cards — counted from the same readings, with no new Jev call; a trait has the same name on the card, the creator page and the coin page.
- **Base profile** (`core`): what he talks about, his sentiment and depth, and how human the account reads; the card's title comes from here.
- **Personality** (`persona`): behaviours visible in single posts, grouped into Honesty, Emotionality, Social, Agreeable, Rigor, plus Risk style (risk appetite, holding period).
- **Posting** (`tweet_style`): Tone (Humor, Emotional intensity, Irony, Checkable) and Rhythm (posts a day, hours, threads, emoji — computed, not asked of Jev).
- **Coin picking** (`coin_style`): coin posts only: tiers, sectors, pick reasons, call types, the 11 themes, the 10 reasons and rejecting tokens, plus Habits (chains, launchpads, market caps, following up — shown only).

The four cards always run together and are not sold separately. The three ways to run them differ only in how many posts are read and the price:
- Free run (once per person): last 10 days, up to 10 posts, free; cannot be listed as a creator module — 10 posts hold too few coin posts, so coin picking would almost always be can't tell.
- Free seat (verified X accounts): last 365 days, up to 1000 posts, free; can be listed as a creator module.
- Paid: last 365 days, up to 1000 posts, 1 USDG; can be listed as a creator module.

### Example: Sam and three new coins

Of Sam's 100 posts, 30% are jokes; of his 40 coin posts, 35% are about Animal mascot coins, 25% give “Lore” as the reason, and only 3% bring up “Tech depth”. Each new coin is compared with these numbers question by question; the four cards are weighted into one overall with the default weights (5/15/30/50).
- Coin A (An animal coin with a story; the launcher's posts joke a lot and never pick fights): Alike 6 · Unlike 1 · Can't tell 0 · Neither 2 (9 in all) · overall 85%; coverage 100% → Strict ✓, Standard ✓, Loose ✓
- Coin B (An animal coin with no story that leads with tech; the launcher's posts don't joke but do pick fights): Alike 5 · Unlike 3 · Can't tell 0 · Neither 1 (9 in all) · overall 60%; coverage 100% → Strict ✗, Standard ✓, Loose ✓
- Coin C (An animal coin with only a name and pitch, and no launcher X account): Alike 2 · Unlike 1 · Can't tell 6 · Neither 0 (9 in all) · overall 66.7%; coverage 50% → Strict ✗, Standard ✓, Loose ✓
B is unlike on two cards, so its overall only reaches 60%: Standard, not Strict. C has no launcher account, so the personality and posting cards can't be told and their weight is re-spread: only the base and coin-picking cards count (coverage 50%), just enough. Any less coverage and the overall reads can't tell, passing nothing.

### The rules: the same questions, compared one by one

The same questions: on the creator's side each of his posts is asked once and counted into the four cards' shares, distributions and score bands; on the coin's side the coin's name, ticker, pitch and optional fields, plus the launcher's X bio and posts, go to Jev as one package — same questions, same options, word for word, with the subject changed to “this launch”.

No post is cut short: only when the package is too long are posts dropped, fewest likes + reposts + replies + quotes first, and the coin page says how many. The coin's own fields are never dropped. An answer Jev is unsure of (no option clearly ahead, or a score pulled both ways) counts as can't tell.

A yes/no question looks at his share: he often has it (≥ 10%) and so does the coin → alike; he often has it and the coin doesn't → unlike (lacks what he usually wants); he almost never has it (< 5%) and the coin does → unlike (he stays away from it); neither has it → listed, not scored; in between → can't tell.

A one-choice question looks at how much of his distribution the coin's answer takes: ≥ 20% alike, < 5% unlike, in between can't tell; his “none” is left out of the count, and a coin answering “none” is can't tell. A 0–3 score question is cut into low / mid / high and compared as a three-way choice. The account question (bot-like) uses 50% as its yes line.

Each card: similarity = alike ÷ (alike + unlike). Can't tell and neither-has-it stay out of the count but are always listed; a card with nothing comparable can't be told.

The overall = the four cards weighted (default 5/15/30/50; each subscriber group sets its own with sliders, always adding up to 100). Cards that can't be told, or weigh 0, drop out and the rest are re-spread by their weights. The comparable cards' weights add up to the coverage; under 50% the overall reads can't tell, so one lightly weighted card never stands for the whole.

Not compared: subject over time, following up on calls, posting rhythm, titles, token-talk share, coins called, repeat calls, chain, launchpad (they need a long record, or are the same for every coin); the five personality factors are sums of the markers and are shown, not counted twice. Market-cap range, followers, likes / reposts / replies / quotes are shown only. Five questions — main field, topic field, sentiment, conviction, falsifiable — are asked and listed with both sides and the verdict, but not scored: creators in the same field answer them almost alike, and the self-identification backtest showed they only raise everyone's similarity together.

⚠️ Every threshold is provisional, waiting for calibration (yes/no 10% / 5%, one-choice 20% / 5%, coverage 50%, tiers 75% / 60% / 50%): the numbers will change, and this page follows the same spec file.

### Three thresholds

When you set up a group you pick one, which decides how high a creator's overall similarity must be to pass; then how many of the group's creators must pass before you are notified.
- **Strict** (`strict`): Overall similarity ≥ 75%. E.g. Sam at 80% overall → passes; 70% → does not
- **Standard** (`standard`): Overall similarity ≥ 60%. E.g. Sam at 65% overall → passes; 55% → does not
- **Loose** (`loose`): Overall similarity ≥ 50%. E.g. Sam at 55% overall → passes; 45% → does not
- Whichever tier: a creator whose comparable cards weigh less than 50% in all (coverage too short) does not pass.
- Notify only when at least this many of the group's creators each pass the threshold above. A creator with no comparison profile yet (module waiting to be recomputed) does not pass.
- Coins that miss the threshold are still charged (the judging was done), but they are not pushed and no webhook is sent; they sit under “Below threshold” on the notifications page, with what fell short.

### Every question links back to the source

Every question carries evidence from both sides: his posts read as “yes” (each opens the post on x.com), and which parts of this coin Jev read (the coin, the launcher's bio, the launcher's posts). Only what was there at launch is read — never later prices or chatter — so the outcome cannot leak into the reading.

### For programs

The API and webhooks carry the same numbers:
- `GET /api/v1/creators → compare` — whether each creator can be compared, and per card how many questions he has a number for (null = too few posts for that card)
- `GET /api/v1/launches/{id} → result.match` — the group's threshold result (with the group's weights), and each creator's four card counts (scored questions only; each question carries scored, false for the five shown-only ones), overall similarity and coverage, and whether they pass each tier
- `webhook → data.match` — the group's threshold result when pushed, with each member's four card counts, overall (group weights) and pass; coins below the threshold are not sent
- Field-by-field: https://jevvis.app/docs#thresholds

### Limits

- This compares style. It does not predict price, or whether he will buy: in our research a profile built from posts could not tell what a person actually buys — creators bought only about 14% of the coins they called. Alike means close to how he usually is, nothing more.
- Every question was checked against blind human labels: Jev agrees with the labellers at κ ≈ 0.55–0.85; theme classification is weaker (≈ 0.45). A single item can be read wrong — the evidence is there so you can check it.
- With too few posts a whole card can't be told (under 10 posts, every card; under 5 coin posts, coin picking); with little launch material, many questions are can't tell.
- Until an older card or module is recomputed into a comparison profile, that creator passes no threshold, and no old number is used in its place.

Full page with the example: https://jevvis.app/methodology

## Reading what you get

### A Jevvis X card

- Tap a card to flip it: summary on the front, evidence on the back. Level I / II / III shows how complete the data is — not a rating of the account.
- The back lists the checks behind the front: Template checks (matched → not matched → insufficient data). Each one opens the posts it was read from.
- A number on a card is a share of the posts read (e.g. 30% jokes = 30 of 100 posts; coin-picking shares count coin posts only). A creator module compares new coins with exactly these numbers, so the card is what a subscriber is buying.
- A card or line marked can't tell had too few posts for it; it is not a low score.

### A coin's result (coin page, notification, API)

- One line per creator: Alike · Unlike · Can't tell · Neither (all questions) · overall. Alike: the coin is like how this creator usually is on that question. Unlike: it lacks what he usually has, or has what he stays away from — the reason says which. Can't tell: one side is unsure or the material is thin. Neither: both lack it; listed, not scored.
- Overall: each card's alike ÷ (alike + unlike), weighted by card. Coverage: how much of the weight had something to compare; under 50% the overall reads can't tell and the creator passes nothing.
- High overall with high coverage: the coin is close to how this creator usually picks and posts. It is not a price call and not a sign he will buy (see Limits).
- Many can't tell or low coverage means not enough material, not unlike. A launcher fixes it with an X profile and the notes above; a subscriber should read it as unknown.
- A notification marked passed met the group's threshold (Strict / Standard / Loose) with enough creators; one under “Below threshold” was judged and charged but not pushed, and says what fell short.
- Before acting on a single question, open its evidence: his posts on one side, what Jev read from the coin on the other.
- Programs get the same numbers in `result.match` and the webhook's `data.match` (see For programs above).

## Fees

- **Jevvis X analysis**: every run is the same 4 cards (base profile, personality, posting, coin picking); there are no cards to pick or add. Three ways to run it, differing only in scope and price: free once per person (last 10 days / up to 10 posts); a free founding seat (verified X accounts; last 365 days / up to 1000 posts; live count: https://jevvis.app/api/offer); or 1 USDG (last 365 days / up to 1000 posts). Only the 1000-post analyses can become creator modules. The amount charged is the one on the order.
- **Subscription**: $0.001 (USDG) per new coin per subscribed creator who answers, from the prepaid balance. Creators who cannot answer are not charged. When the balance cannot cover the next coin, all subscriptions are switched off. Past charges are not refunded.
- **Top-up**: USDG on Robinhood Chain, sent from the signed-in wallet to the treasury, credited after 3 confirmations; minimum $0.10.
- **Naming creators at launch**: $0.001 (USDG) per named creator, charged only for creators who answer.
- **Creators earn** 50% of each subscription or naming charge on their reads; the platform keeps the rest.
- **Launching** without named creators costs nothing beyond pons' launch fee (read from chain when the transaction is built) and gas.
- **Trading fees** (every trade on a coin launched through Jevvis; launcher tax 0–10%):
  - Launching wallet: 0.5% + launcher tax (your `creatorTaxBps`). The rest of the pons creator share plus all of your tax, paid out through this coin's fee-split contract.
  - Jevvis ecosystem: 0.2%. Fixed. Taken from the pons creator share (0.7%), not added on top.
  - pons: 0.3%. Fixed, pons' own protocol share.
  - A trader pays pons' 1% trading fee plus the launcher tax on every trade.

## Integrate (programs and agents)

- **Machine-readable entry points**: this file (https://jevvis.app/llms.txt) and the API reference (https://jevvis.app/docs).
- **Identity**: a wallet sign-in — the wallet signs a one-time challenge bound to that address and this site; it is free and sends no transaction. X sign-in is only needed for X analyses and for creators.
- **API keys**: made at https://jevvis.app/user/keys by a signed-in wallet and bound to it. A key acts as that wallet (create launches, build the transactions it signs, read their results, manage webhooks); it cannot sign or move funds.
- **Launch API and webhooks**: https://jevvis.app/api/v1 — see the API section. Webhooks push every new notification of the key's wallet (its groups' reads on new coins, and launch broadcasts), signed with HMAC-SHA256.
- **Payments are crypto, from the user's own wallet**: plain USDG transfers on Robinhood Chain, sent to the treasury and credited after 3 confirmations; there is no card checkout and Jevvis never holds anyone's keys. The credited USDG is a prepaid balance; each judgment is then charged from it per coin per creator, with no further transaction.
- **Paid X analyses**: one order of 1 USDG in USDG on Robinhood Chain, from the signed-in wallet to the address on the order; the run starts once the transfer confirms.
- **Trading fees settle on chain**: every trade of a coin launched through Jevvis pays into that coin's fee-split contract; a claim (anyone may send it) pays out only to the launcher and the ecosystem distributor. See Contracts below.
- **Not available through the API today**: subscribing, groups and top-ups (site only, wallet signed in); running X analyses; reading a coin's per-creator judgments on demand (a program receives its own groups' reads through webhooks, and its own launches' result summary through the launch API).

## API

- Base URL: https://jevvis.app/api/v1
- Auth: `Authorization: Bearer jev_…` — an API key from https://jevvis.app/user/keys. A key belongs to one wallet; launches are made from that wallet, which signs and sends its own transactions.
- Flow: create a launch → get its transaction → sign and send it from the wallet → confirm with the hash. A coin trades against one of 70 pair assets (ETH, USDG, stock tokens and more).
- Endpoints:
  - `POST /images` — Upload an image. Stores a coin logo and returns its URL — the only kind of URL `imageUrl` accepts when you create a launch.
  - `POST /launches` — Create a launch. Registers a coin to launch from the key's wallet.
  - `GET /launches/{id}/transaction` — Get the launch transaction. Returns the unsigned transaction(s) the launching wallet signs and sends itself — we never hold a key.
  - `POST /launches/{id}/confirm` — Confirm a launch. Hand back the hash of the launch transaction you sent.
  - `GET /launches/{id}` — Retrieve a launch. One of the key's launches with its current status.
  - `GET /launches` — List your launches. Every launch created from the key's wallet, newest first — including ones not launched yet and why a mismatch was rejected.
  - `GET /creators` — List creators. The creator modules a launch may name in `judges`, and the price per named creator (`unitPriceMinor`, in 10⁻⁶ USD).
  - `POST /groups/{id}/confirm-match` — Confirm a group's threshold. 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.
  - `POST /webhooks` — Register a webhook. 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.
  - `GET /webhooks` — List webhooks. The key wallet's webhooks with their last 20 deliveries.
  - `DELETE /webhooks/{id}` — Delete a webhook. Stops pushing to that URL.
  - `POST /webhooks/{id}/enable` — Re-enable a webhook. A webhook is switched off after 20 failed deliveries in a row.
- Rate limits:
  - Per IP address, before the key is checked: 120 per minute
  - Upload an image (per key): 20 per 10 minutes
  - Create a launch (per key): 10 per 10 minutes
  - Get the launch transaction (per key): 20 per 10 minutes
  - Confirm a launch (per key): 30 per minute
  - Retrieve / list (per key): 60 per minute
- Webhooks: each new notification of the key's wallet is POSTed as JSON, `type` `notification.created` or `notification.updated`. Headers: `Jevvis-Signature`, `Jevvis-Event-Id`, `Jevvis-Delivery`.
  - 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.
- Full reference (parameters, responses, errors, code samples): https://jevvis.app/docs

## Contracts and addresses (verify on-chain)

Chain: Robinhood Chain (chain id 4663), RPC https://rpc.mainnet.chain.robinhood.com.
- Treasury: [0x231f34fb12274b84d2c14e95674ca3d2fa2da0e1](https://robinhoodchain.blockscout.com/address/0x231f34fb12274b84d2c14e95674ca3d2fa2da0e1) — Where subscribers send USDG top-ups, and where creator payouts are paid from.
- LaunchHelper: [0xd7de57aa7c41519498ecb6efee00c301b74ce5e5](https://robinhoodchain.blockscout.com/address/0xd7de57aa7c41519498ecb6efee00c301b74ce5e5) — The Jevvis launch contract every launch goes through; it creates the coin's fee splitter.
- Fee-splitter factory: [0x05904bb163fe8768aa62f98af2ca77ed630e4088](https://robinhoodchain.blockscout.com/address/0x05904bb163fe8768aa62f98af2ca77ed630e4088) — Creates one fee-split contract per coin. Read it from `LaunchHelper.splitters()`.
- Ecosystem distributor: [0xb5682848eaeb6ac6a42fde027a1ce6d70ae5c9f5](https://robinhoodchain.blockscout.com/address/0xb5682848eaeb6ac6a42fde027a1ce6d70ae5c9f5) — Receives the Jevvis ecosystem share of trading fees. Read it from the factory's `ecosystem()`.
- Distributor owner: [0x096a38ff5cbdccac45b1ec2ff39d22a92acdbb91](https://robinhoodchain.blockscout.com/address/0x096a38ff5cbdccac45b1ec2ff39d22a92acdbb91) — The Jevvis team wallet that controls the distributor; payee changes are time-locked (`delay()`, 48 hours on the deployed contracts) and can be read in advance with `pendingPayees()`. Read it from the distributor's `owner()`.
- pons fee escrow: [0xd3afeb2a57f70ef218aa82451c51b2fb0416ac9e](https://robinhoodchain.blockscout.com/address/0xd3afeb2a57f70ef218aa82451c51b2fb0416ac9e) — pons' fee escrow the splitters settle through. Read it from the factory's `escrow()`.
- pons router: [0xe33e9e479df8802cb0866d5d05258bec4cf62948](https://robinhoodchain.blockscout.com/address/0xe33e9e479df8802cb0866d5d05258bec4cf62948) — pons' launch and trade router.
- USDG: [0x5fc5360d0400a0fd4f2af552add042d716f1d168](https://robinhoodchain.blockscout.com/address/0x5fc5360d0400a0fd4f2af552add042d716f1d168) — The stablecoin used for top-ups, charges and payouts.
- On-chain fee split (factory `creatorFeeBps()` / `ecosystemFeeBps()`): pons creator share 0.7% of trade volume, of which 0.2% goes to the ecosystem distributor; the launcher tax is added on top and goes to the launcher.
- How to verify: call `splitters()` on the LaunchHelper → the factory; on the factory `ecosystem()` → the distributor and `escrow()` → the pons escrow; on the distributor `owner()` → the team wallet.

## Links

- [API reference](https://jevvis.app/docs): full launch API, webhooks, errors
- [How matching works](https://jevvis.app/methodology): how a coin is checked against each creator, with an example
- [Terms](https://jevvis.app/terms)
- [Privacy](https://jevvis.app/privacy)