The Vulpine coins API

For exchanges and swaps that want to list Vulpine coins automatically, the moment they graduate.

What a coin is

A coin launched on Vulpine is a BSV-21 token. It starts out sold along a bonding curve: a ladder of steps, each a fixed amount of the coin at a fixed price, each step dearer than the last. Every satoshi a buyer pays goes into a locked pot, never to the creator directly. When every step of the curve has sold, the coin has graduated.

Coins launched from 18 October 2026 hold a fifth of their supply back, in the pot itself, and their makers can give older coins the same. At graduation the pot and those coins become the coin's pool: BSV and the coin together, on chain, which the house signs for by one public rule (a constant product with a 2.3% fee that stays in the pool: 0.3% for the pool's share holders, 1% #1's and 1% #2's as shares), for any swap that follows it: Vulpine's own (Moonfox) and any other, Janus's among them. None of a pool coin's pot goes to its maker. An older coin with nothing held back trades by listing, and two arbiters release its pot to its creator. The pools are in docs/PROTOCOL.md, 9.6.3a.

Graduation is the moment to list. This API says which coins have graduated, and when, with everything needed to list one: the token id, the symbol, decimals, supply, icon, and the price it graduated at.

Endpoints

Base: https://api.vulpinenetwork.com/api (the same answers come from https://fwetch.lol/api). No key, no sign-up. Every answer is JSON, open to every origin (CORS), and cached for 15 seconds.

GET /v1/graduated?since=<unix seconds>&limit=<1-200>coins whose curve sold out, changed at or after since (updatedAt: graduating, a pot paid out, a pool opening), newest first
`GET /v1/coins?status=<launching\graduated>&limit=<1-200>`every coin, newest launch first, optionally only one status
GET /v1/coins/<token id or launch txid>one coin
GET /v1this list, as JSON

Listing graduated coins automatically

  1. Ask GET /v1/graduated?since=0 once; list every coin it returns.
  2. Keep the answer's next (the newest graduatedAt you have seen).
  3. Every minute or so, ask GET /v1/graduated?since=<next>. Anything new in graduated has just graduated: list it. A coin you have already listed can come back in the answer (it graduated at exactly since); go by its token.
curl -s 'https://api.vulpinenetwork.com/api/v1/graduated?since=0'
{
  "v": 1,
  "now": 1791333333,
  "next": 1791243844,
  "graduated": [ { "token": "e6ff…393f_0", "symbol": "VTEST", "status": "graduated", "graduatedAt": 1791243844, "…": "…" } ]
}

A coin

Every endpoint gives a coin in this one shape. A real one (a test coin, graduated):

{
  "token": "e6ff6744267a7f696644beccd79d8a8890658232cda64d03946471359fe6393f_0",
  "standard": "bsv-21",
  "symbol": "VTEST",
  "name": "Vulpine test coin",
  "decimals": 0,
  "supply": "300",
  "icon": "https://ordinals.gorillapool.io/content/e6ff6744267a7f696644beccd79d8a8890658232cda64d03946471359fe6393f_1",
  "iconOutpoint": "e6ff6744267a7f696644beccd79d8a8890658232cda64d03946471359fe6393f_1",
  "about": "A throwaway coin the house launched to test selling back.",
  "creator": "114AnVbavvmXUkukiVG2R3MKCi8oKRALeg",
  "status": "graduated",
  "launchedAt": 1791209069,
  "graduatedAt": 1791243844,
  "curve": { "steps": 3, "sold": 3, "pulled": 0, "raisedSats": 90000, "goalSats": 90000, "nextStepSats": null },
  "price": { "satsPerToken": 400, "usdPerToken": 0.00008 },
  "marketCap": { "sats": 120000, "usd": 0.024 },
  "pot": { "lockedSats": 90000, "released": false, "releaseTxid": null },
  "holders": 3,
  "launchTxid": "ade251c988e59d123508c41e358b5317b16cc50bf1ad7536d99599536d70d4c1",
  "links": {
    "coin": "https://api.vulpinenetwork.com/api/v1/coins/e6ff…393f_0",
    "holders": "https://api.vulpinenetwork.com/api/launch/e6ff…393f_0/holders",
    "page": "https://fwetch.lol/#/launch/e6ff…393f_0",
    "launchTx": "https://whatsonchain.com/tx/ade251c9…d4c1"
  }
}
fieldmeaning
tokenthe BSV-21 token id: the outpoint of its deploy+mint (<txid>_<vout>)
symbol, name, decimals, supplyas deployed; supply is in the token's smallest unit, as a string
iconthe coin's picture, inscribed on chain (iconOutpoint), served by GorillaPool
statuslaunching (steps left on the curve) or graduated (every step sold)
launchedAt, graduatedAtunix seconds; graduatedAt is when its last step sold, null until then
curveits steps, how many sold or were taken back (pulled), what they raised, the next step's price
price.satsPerTokenfor a whole token (10^decimals units): the next step's price, or once graduated, the top of the curve
price.usdPerToken, marketCap.usdat WhatsOnChain's BSV/USD rate, null when it cannot be read
potwhat the curve raised; goesTo is pool for a pool coin (its pot and held coins become its pool) or maker (two arbiters release it to the creator, releaseTxid)
version2: its pool opens by itself when its ladder sells out; 1: launched before pools, so its pool is opened by hand
poola pool coin's coinsHeld and heldOutpoint; once its pool is open, open: true, the address the token index lists it under, bsvSats, coins, satsPerCoin and link to the pool itself
holdershow many addresses bought from the curve

Pools

GET /pool/<token>the coin's pool: its lock and both keys, its outputs, what it holds, the coin's index fund; ?buy=<n> or ?sell=<n> for a quote
POST /pool/<token>/cosign{ tx, parents? }: the house's signatures on a swap that follows the rule, and each pool input's whole unlock (unlocks), or why not (403)
GET /poolsevery open pool

A swap spends the whole pool and leaves one output of its BSV and one of its coins at the same lock, keeps the product after the 1% fee, balances the coin, and pays the coin's index fund 1,000 sats for each output carrying it. Each pool input opens with <the second key's signature> <the house's signature> <the house's key>; both keys are the house's, so unlocks has each one whole.

Notes

What a wallet holds

GET /api/tokens/held?addrs=<address>,<address>,… (forty at most) — every token those addresses hold, as the 1Sat token index counts them: { tokens: [{ id, protocol, sym, dec, icon, confirmed, pending, listed, by: [{ addr, confirmed, pending, listed }], name, vulpine, price, change24h, valueSats }], failed: [addresses the index did not answer for] }. Amounts are in the token's smallest unit; price is in sats for one whole coin, and only Vulpine's coins carry it.