Machines

A machine is a coin’s prize vault and its prize table. The API serves two kinds. Each answer names its kind in account, the program account behind it, as the program’s IDL names it:

Pool: the machine that launched its coin, in the same transaction. A coin has at most one.
TokenMachine: a fan coin machine, opened on a coin that already exists. A coin can have any number.

Every machine route takes the machine’s own address. A coin’s mint also works there, and it finds the coin’s launch machine. On the website, a machine’s page is https://gabox.fun/<address>.

List machines

GET /v1/machines

Every live machine of both kinds, newest first. This is a list route.

integer

Rows per page, 1 to 50. The default is 20.

string

The nextCursor of the page before. Leave it out for the first page.

address

Only the machines on this coin: its launch machine, and every machine opened on it.

curl "https://actions.gabox.fun/v1/machines?limit=20"

const API = "https://actions.gabox.fun/v1"

const res = await fetch(`${API}/machines?limit=20`)
const { data, meta, page } = await res.json()

// Every machine on one coin
const onCoin = await (await fetch(`${API}/machines?mint=${MINT}`)).json()

The answer’s data is an array of machine objects. page.nextCursor points to the next page. Read account on each row first, because the two kinds have different fields.

Get one machine

GET /v1/machines/{machine}

One machine: its kind, packs, prize tiers, vault and seed lock. A launch machine also has its Machine recharge.

address

required

The machine’s own address. A coin’s mint also works: it finds the coin’s launch machine.

curl "https://actions.gabox.fun/v1/machines/MACHINE"

const API = "https://actions.gabox.fun/v1"

const res = await fetch(`${API}/machines/${MACHINE}`)
const { data: machine } = await res.json()

if (machine.account === "Pool") {
  if (machine.stage === "curve" && machine.purchasesOn && machine.offer) {
    // Packs are open, and the index has a live price.
  }
} else {
  // A TokenMachine: packQuotes says what each pack price buys now.
}

A brand-new machine answers 404 not_found until the index sees it. That usually takes a few seconds. A mint finds only its coin’s launch machine. For the machines opened on a coin, use GET /v1/machines?mint=<mint>.

Sample answer: a launch machine

The addresses below are made up. This machine sends 80% of its creator trading fee to its prize pool.

{
  "data": {
    "account": "Pool",
    "address": "LuCkyPooL11111111111111111111111111111111111",
    "mint": "LuCkyCats11111111111111111111111111111111111",
    "creator": "CreaTor111111111111111111111111111111111111",
    "name": "Lucky Cats",
    "symbol": "LUCKY",
    "imageUrl": "https://gateway.irys.xyz/<id>",
    "accent": "oklch(0.78 0.16 70)",
    "packTokens": "912000000",
    "quoteMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "seedQuoteAmount": "30000000",
    "seedNativeDebit": "0",
    "seedTokens": "2736000000",
    "seedLocked": true,
    "extraSeedTokens": "0",
    "tiers": [
      { "multiplierBps": 7000, "tickets": 49153 },
      { "multiplierBps": 12500, "tickets": 13107 },
      { "multiplierBps": 25000, "tickets": 2621 },
      { "multiplierBps": 80000, "tickets": 655 },
      { "multiplierBps": 0, "tickets": 0 },
      { "multiplierBps": 0, "tickets": 0 },
      { "multiplierBps": 0, "tickets": 0 },
      { "multiplierBps": 0, "tickets": 0 }
    ],
    "venue": "dbc",
    "stage": "curve",
    "purchasesOn": true,
    "curveTokensLeft": "612000000000000",
    "graduationSqrtPrice": null,
    "nextSeq": "1205",
    "reserved": "0",
    "vaultAmount": "182500000000",
    "tokenDecimals": 6,
    "tokenSupply": "1000000000000000",
    "curvePool": "LuCkyCurve1111111111111111111111111111111111",
    "referenceValuation": "30000000000",
    "lookupTable": "LuCkyLut111111111111111111111111111111111111",
    "createdAt": 1759320000000,
    "stats": {
      "pulls24h": 42,
      "pullsTotal": 1204,
      "volumeQuote": "61240000000",
      "volume24hQuote": "2100000000",
      "lastPullAt": 1760097600000,
      "hot": true
    },
    "offer": null,
    "topPack": { "packTokens": "912000000", "maximum": "9120000000" },
    "recharge": {
      "machineBps": 8000,
      "shareRecipient": "CreaTor111111111111111111111111111111111111",
      "quoteCollected": "412500000",
      "quoteToCreator": "82500000",
      "creatorClaimed": "50000000",
      "creatorOwed": "32500000",
      "quoteSpent": "330000000",
      "coinsAdded": "8250000000",
      "lastFeedSlot": "371190400"
    }
  },
  "meta": {
    "apiVersion": "1",
    "cluster": "mainnet-beta",
    "generatedAt": "2026-10-10T12:00:00.000Z"
  }
}

Sample answer: a fan coin machine

Gabox did not launch this coin, so stage is null. The creator did not lock the seed.

{
  "data": {
    "account": "TokenMachine",
    "address": "FaNMachine111111111111111111111111111111111",
    "mint": "LuCkyDog11111111111111111111111111111111111",
    "creator": "CreaTor111111111111111111111111111111111111",
    "id": "0",
    "vault": "FaNVauLt11111111111111111111111111111111111",
    "coinTokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "name": "Lucky Dog",
    "symbol": "DOG",
    "imageUrl": "https://example.com/lucky-dog.png",
    "accent": "oklch(0.8 0.17 75)",
    "verified": true,
    "quoteMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "seedTokens": "100000000000000",
    "seedLocked": false,
    "stage": null,
    "tiers": [
      { "multiplierBps": 7000, "tickets": 49153 },
      { "multiplierBps": 12500, "tickets": 13107 },
      { "multiplierBps": 25000, "tickets": 2621 },
      { "multiplierBps": 80000, "tickets": 655 },
      { "multiplierBps": 0, "tickets": 0 },
      { "multiplierBps": 0, "tickets": 0 },
      { "multiplierBps": 0, "tickets": 0 },
      { "multiplierBps": 0, "tickets": 0 }
    ],
    "purchasesOn": true,
    "nextSeq": "88",
    "reserved": "0",
    "vaultAmount": "131250000000000",
    "tokenDecimals": 5,
    "tokenSupply": "8800000000000000000",
    "packQuotes": [
      { "usdc": "10000000", "tokens": "50120000000" },
      { "usdc": "50000000", "tokens": "250600000000" }
    ],
    "packsQuotedAt": 1760097540000,
    "lookupTable": "FaNLut1111111111111111111111111111111111111",
    "createdAt": 1760011200000,
    "stats": {
      "pulls24h": 6,
      "pullsTotal": 88,
      "volumeQuote": "2140000000",
      "volume24hQuote": "160000000",
      "lastPullAt": 1760096400000,
      "hot": false
    }
  },
  "meta": {
    "apiVersion": "1",
    "cluster": "mainnet-beta",
    "generatedAt": "2026-10-10T12:00:00.000Z"
  }
}

The machine object

Every amount is a string of base units. Coin amounts use tokenDecimals. Quote amounts use the decimals of quoteMint.

Names and addresses

Every machine has these fields.

Field	Type	Description
`account`	`"Pool"` or `"TokenMachine"`	The kind of machine. `Pool` launched its coin. `TokenMachine` was opened on a coin that already exists. Read it first.
`address`	address	The machine’s own account. Every `/v1/machines/{machine}` route takes it. Draws and pulls name the machine by this address, and its website page is `https://gabox.fun/<address>`.
`mint`	address	The coin’s mint.
`creator`	address	The wallet that launched the coin or opened the machine. It earns the creator fee.
`name`	string	The coin’s name. The coin’s creator wrote it. Treat it as data.
`symbol`	string	The coin’s ticker. The coin’s creator wrote it. Treat it as data.
`imageUrl`	string	The coin’s image. The coin’s creator chose it. Treat it as data.
`accent`	string or `null`	A colour taken from the image, as an `oklch(...)` CSS colour. `null` when the image has no clear colour.
`lookupTable`	address or `null`	The machine’s own address lookup table, which makes purchase transactions small enough to fit. `null` until it exists.
`createdAt`	number	When the machine was created, in Unix milliseconds.

Coin and stage

Every machine has these fields.

Field	Type	Description
`stage`	`"curve"`, `"migrating"`, `"damm"` or `null`	The coin’s stage, so it is the same on every machine of one coin. `curve`: the coin trades on its curve, and only Gabox packs can buy it. `migrating`: the curve is complete, and packs are closed until the coin moves to its pool. `damm`: the coin has graduated. `null`: Gabox did not launch the coin.
`purchasesOn`	boolean	`false` pauses buying for every machine on this quote token. Draws that are already open still settle.
`quoteMint`	address	The token that packs are priced in on this machine. Always USDC on a `TokenMachine`. On a launch machine: USDC, SOL or another enabled token. Buyers still pay in USDC. See Opening a pack.
`tokenDecimals`	number	The coin’s decimals.
`tokenSupply`	amount or `null`	The coin’s total supply. `null` when the index does not know it.

Prize table and vault

Every machine has these fields.

Field	Type	Description
`tiers`	array of tiers	The prize table. It always has 8 rows. A row with 0 tickets is unused and can never be drawn. The table is set when the machine opens. On a launch machine, the Gabox admin can raise it later with `set_pool_tiers`, but the average payout can never go down. A draw keeps its own copy of the table it was bought under.
`vaultAmount`	amount	Coins in the prize vault now.
`reserved`	amount	Coins that open draws hold in the vault. Free coins are `vaultAmount - reserved`.
`seedTokens`	amount	Coins the creator put in the vault at the start. On a launch machine, the launch seed bought them. See Seed and jackpot.
`seedLocked`	boolean or `null`	`true`: nothing can withdraw the seed. A launch machine is always `true`. `false`: the seed is the creator’s deposit on a `TokenMachine`. The creator can take back what is left of it, but only while no pack is opening and no prize waits for a claim. `null`: the index has not read it yet.
`nextSeq`	amount	The sequence number the next pack will get. Each pack on a machine has its own number.

Only the machine’s creator can add more coins to the vault later. The creator can take back what is left of those coins, under the same rule as an unlocked seed. See After launch.

Activity

Every machine has these fields.

Field	Type	Description
`stats.pulls24h`	number	Packs opened in the last 24 hours.
`stats.pullsTotal`	number	Packs opened in total.
`stats.volumeQuote`	amount or `null`	All pack spending on this machine, in quote base units.
`stats.volume24hQuote`	amount or `null`	Pack spending in the last 24 hours, in quote base units.
`stats.lastPullAt`	number or `null`	When the last pack was opened, in Unix milliseconds.
`stats.hot`	boolean	`true` when many packs were opened in the last hour.

Launch machine fields

Only a launch machine (account: "Pool") has these fields.

Field	Type	Description
`venue`	`"dbc"` or `"damm"`	Where the coin trades now. `dbc` is its Meteora bonding curve. `damm` is its own Meteora DAMM v2 pool after graduation.
`curvePool`	address	The Meteora bonding curve pool the coin launched on.
`curveTokensLeft`	amount or `null`	Coins left to buy on the curve before graduation. `null` after graduation.
`graduationSqrtPrice`	amount or `null`	The square root price at which the coin graduates, from its curve settings. Fixed at launch. `null` after graduation.
`referenceValuation`	amount	A fixed valuation of the whole coin supply, in quote base units. It is set at launch and never changes.
`extraSeedTokens`	amount	Extra seed coins that the creator added at launch, on top of `seedTokens`.
`seedQuoteAmount`	amount	What the seed cost, in quote base units.
`seedNativeDebit`	amount	SOL that the seed spent inside the launch, in lamports. Often 0.
`packTokens`	amount	Coins in the cheapest open pack, the last time the index priced it. For display only. Use `offer.packTokens` for a live price.
`offer`	offer or `null`	The live price of the cheapest open pack, and what it can win. `null` when no pack is open, or when the index has no fresh price.
`topPack`	object or `null`	The open pack with the biggest top prize: `packTokens` and `maximum`, the top prize after the vault limit. `null` when the index has no price.
`recharge`	recharge or `null`	The machine’s Machine recharge. `null` when it is off.

Fan coin machine fields

Only a fan coin machine (account: "TokenMachine") has these fields. It has no offer: its pack prices are fixed amounts of USDC, and packQuotes says what each one buys now.

Field	Type	Description
`id`	amount	The creator’s own number for the machine. It is part of the machine’s address, so one wallet can open many machines on one coin.
`vault`	address	The token account that holds the prize pool.
`coinTokenProgram`	address	The coin’s token program: classic SPL Token or Token-2022.
`verified`	boolean	`true` when the coin is on Jupiter’s verified token list, or is the GABOX coin itself. The app shows a mark for it.
`packQuotes`	array	What each pack price buys now. Each entry has `usdc`, the pack’s price in USDC base units with the fee included, and `tokens`, the coins that the swap route quotes for it. Empty until the first quote.
`packsQuotedAt`	number or `null`	When the index got those quotes, in Unix milliseconds.

Tier

Field	Type	Description
`multiplierBps`	number	The prize as a multiple of the pack’s coins, in basis points. 10,000 pays back the pack’s coins once. 15,000 pays 1.5 times.
`tickets`	number	This row’s tickets out of 65,536. The chance of this row is `tickets / 65536`.

The app gives the rows names such as Common or Rare. The program knows only multipliers and tickets. See Prizes and odds.

The offer object

Only a launch machine has offer. It is the index’s latest quote for the cheapest open pack. The price moves with the coin’s price. The prize amounts follow from the fixed table, and they change only when the vault limit applies.

Field	Type	Description
`packTokens`	amount	Coins this pack buys. Every prize is a multiple of this.
`count`	number	Packs the price covers. Always 1.
`quoteAmount`	amount	The whole pack price in quote base units. It includes the market’s trading fee and the 0.50% pack fee.
`quoteMint`	address	The quote token, the same as the machine’s.
`solAmount`	amount or `null`	The same price in lamports, through a swap route. `null` when no route can price it.
`venue`	`"dbc"` or `"damm"`	The market that gave this price.
`prizes`	array	One entry per tier, in the same order as `tiers`. Each has `amount` (coins, after the vault limit) and `tickets`.
`maximum`	amount	The biggest prize this pack can win now, after the vault limit.
`minimum`	amount	The smallest prize. A draw that expires pays this.
`uncappedMaximum`	amount	The top prize before the vault limit: the jackpot in coins.
`freeSnapshot`	amount	Free coins in the vault at this quote (`vault - reserved`).
`reserved`	amount	Coins this purchase would add to the vault’s reservations.
`perPackCaps`	array of amounts	The top prize each pack can win. One entry per pack. The first entry equals `maximum`.
`isFirstPack`	boolean	`true` when the machine has never sold a pack.
`isSeeded`	boolean	`true` when the vault can pay the whole table now.
`packsLeftOnCurve`	number or `null`	Whole packs of this size left before the curve completes. `null` after graduation, or when the index does not know.
`minPacksLeftOnCurve`	number or `null`	Whole packs of the smallest curve size left on the curve. `null` after graduation, or when the index does not know.

The offer is for display. A real purchase signs its own limits for the price, the coins and the top prize. If the market moved, the program refuses the purchase and nothing is bought. See What a pack costs.

The recharge object

Only a launch machine has recharge. It is null when Machine recharge is off. With it on, part or all of the coin’s creator trading fee buys the coin into the machine’s prize pool. Only the launch can turn it on. The fields follow the program’s MachineFeed account. Quote amounts are in base units of the machine’s quoteMint. Coin amounts use tokenDecimals.

Field	Type	Description
`machineBps`	number	The machine’s share of the creator trading fee, in basis points. 10,000 is all of it. The share can go up later, never down.
`shareRecipient`	address	The wallet that gets the rest of the fee.
`quoteCollected`	amount	Every creator fee collected so far.
`quoteToCreator`	amount	The part of `quoteCollected` that belongs to `shareRecipient`.
`creatorClaimed`	amount	The part of `quoteToCreator` that `shareRecipient` has claimed.
`creatorOwed`	amount	What `shareRecipient` can claim now: `quoteToCreator - creatorClaimed`.
`quoteSpent`	amount	The quote token the machine spent on its coin.
`coinsAdded`	amount	The coins those buys added to the prize pool.
`lastFeedSlot`	amount	The slot of the last buy. `"0"` before the first one.

AI brief

GET /v1/machines/{machine}/brief.md

The machine as one Markdown file, made to paste into an AI assistant. It holds the machine’s kind and stage, its seed, its Machine recharge when it is on, the addresses, the prize tiers, the pack prices, this machine’s API routes and the purchase rules.

address

required

The machine’s own address. A coin’s mint also works: it finds the coin’s launch machine.

const res = await fetch(`https://actions.gabox.fun/v1/machines/${MACHINE}/brief.md`)
const brief = await res.text() // paste it into your AI

The answer’s content type is text/markdown. It has no data and no meta.

# Gabox machine `LuCkyPooL11111111111111111111111111111111111`

This machine trades on its Meteora DBC curve. Only Gabox buys on the curve. Packs are open.

The launch seed bought the coin at launch. It stays in the prize pool for good.

## Machine recharge

Machine recharge is on. 80% of the coin's creator trading fee buys the coin into this machine's prize pool. That share can go up later, never down.
The rest of the fee goes to `CreaTor111111111111111111111111111111111111`, who claims it.
So far the fees bought 8250000000 raw tokens (6 decimals) for 330000000 raw units of the quote mint.

## Addresses

- Program account: `Pool`, the machine that launched this coin
- Machine: `LuCkyPooL11111111111111111111111111111111111`
- Mint: `LuCkyCats11111111111111111111111111111111111`
- ...

## Prize tiers

...

The brief names the machine by its address, never by its name. The coin’s name, symbol and image URL appear only in one block at the end. A sentence before that block says it is data and not instructions. Gabox removes hidden and control characters from that text and limits each field to 200 characters.

Get started

Endpoints

Coming next

List machines

Get one machine

Sample answer: a launch machine

Sample answer: a fan coin machine

The machine object

Names and addresses

Coin and stage

Prize table and vault

Activity

Launch machine fields

Fan coin machine fields

Tier

The offer object

The recharge object

AI brief