Token Info

Free, keyless reads, for Flap and four.meme tokens alike. Use them to decide what to trade and to size a buy before you call local-trade. Amounts are raw base-unit strings (wei for BNB, 18-decimal units for tokens); fields ending in Formatted are the human-readable decimal. protocol says which launchpad answered, and the shape differs a little between the two: Flap's is below, four.meme's further down.

Token

GET https://api.shrine.trade/bnb/api/token/{address}
GET https://api.shrine.trade/bnb/api/token/{address}?wallet=0x…

JavaScript
Python

const TOKEN = "0x2f1952E00F6BA7655993120B8c41E5ab511e7777";

async function main() {
  const res = await fetch(`https://api.shrine.trade/bnb/api/token/${TOKEN}`);
  const t = await res.json();
  if (t.error) throw new Error(`${t.error}: ${t.message}`);

  console.log(t.symbol, t.status, "| venue:", t.venue, "| progress:", t.progressPct.toFixed(1) + "%");
  console.log("priced in", t.quoteAsset.symbol, "| tax:", t.buyTaxBps, "/", t.sellTaxBps, "bps");
  if (t.tax) console.log("creator has earned", t.tax.totalPaidToBeneficiary, t.quoteAsset.symbol);
}

main();

Save it as token.js and run node token.js - no packages needed.

import requests

TOKEN = "0x2f1952E00F6BA7655993120B8c41E5ab511e7777"

t = requests.get(f"https://api.shrine.trade/bnb/api/token/{TOKEN}").json()
if "error" in t:
    raise SystemExit(f"{t['error']}: {t['message']}")

print(t["symbol"], t["status"], "| venue:", t["venue"], "| progress:", f"{t['progressPct']:.1f}%")
print("priced in", t["quoteAsset"]["symbol"], "| tax:", t["buyTaxBps"], "/", t["sellTaxBps"], "bps")
if t.get("tax"):
    print("creator has earned", t["tax"]["totalPaidToBeneficiary"], t["quoteAsset"]["symbol"])

Save it as token.py, pip install requests, then python token.py.

Add ?wallet=0x… to get buyQuotaRemaining for that wallet. A real response:

{
  "protocol": "FLAP",
  "token": "0x2f1952E00F6BA7655993120B8c41E5ab511e7777",
  "name": "星际巨舰",
  "symbol": "星际巨舰",
  "tokenType": "tax_v3",
  "isTaxToken": true,
  "status": "Tradable",
  "graduated": false,
  "venue": "flap_curve",
  "quoteAsset": {
    "address": "0x0000000000000000000000000000000000000000",
    "symbol": "BNB",
    "decimals": 18,
    "isNative": true
  },
  "pairToken": "BNB",
  "bnbBuysAccepted": true,
  "quoteReserve": "7232115677198697",
  "quoteReserveFormatted": "0.007232115677198697",
  "circulatingSupply": "1058452331420000000000000",
  "circulatingSupplyFormatted": "1058452.33142",
  "graduationSupply": "800000000000000000000000000",
  "graduationSupplyFormatted": "800000000",
  "progressPct": 0.13,
  "price": "5556337995",
  "curveFeeBps": 125,
  "shrineFeeBps": 50,
  "buyTaxBps": 1000,
  "sellTaxBps": 1000,
  "tax": {
    "buyTaxBps": 1000,
    "sellTaxBps": 1000,
    "beneficiary": "0xF31b8fcD326e0aD7837af0aefed60cC71Db82595",
    "beneficiaryIsVault": false,
    "marketingBps": 10000,
    "deflationBps": 0,
    "dividendBps": 0,
    "lpBps": 0,
    "totalPaidToBeneficiary": "0.027083340900000001",
    "pendingForBeneficiary": "0",
    "taxProcessor": "0xaa0093AC156cDd7FE16af7C0a8cEAF3C4b38F38e"
  },
  "curve": {
    "r": "6140000000000000000",
    "h": "107036752000000000000000000",
    "k": "6797205657280000000000000000"
  }
}

Field	Meaning
`tokenType` / `isTaxToken`	`standard` or `tax_v3` (older launches: `tax_v1`, `tax_v2`, `legacy`). A tax token charges `buyTaxBps` / `sellTaxBps` on every trade and pays it to `tax.beneficiary`.
`status` / `graduated` / `venue`	Flap's `Tradable` while on the curve, `DEX` once graduated. `venue` is where a trade goes right now: `flap_curve` or `pancakeswap`.
`quoteAsset` / `pairToken`	What the token is priced in: BNB, or an ERC-20 (USD1, a tokenised stock like NVDAB or TSLAB, another Flap token). `decimals` is not always 18 - XAUT has 6. The full list is in Supported quote assets.
`bnbBuysAccepted`	`true` when a BNB buy works for this token - always for BNB-priced tokens, and for ERC-20-priced ones where Flap swaps BNB in on the way. If `false`, hold the quote asset and use `payWithQuote`.
`quoteReserve` / `circulatingSupply`	How much quote the curve holds and how many tokens it has sold.
`graduationSupply` / `progressPct`	The curve graduates to PancakeSwap once `circulatingSupply` reaches `graduationSupply` (800M on BNB Chain). `progressPct` is how far along it is; 100 once graduated.
`price`	Quote per token, 18-decimal fixed point, as Flap's Portal reports it.
`curveFeeBps` / `shrineFeeBps`	Flap's fee on curve trades (0 after graduation) and ours (0.5%).
`pool`	The PancakeSwap pool, once graduated.
`maxBuyPerWallet` / `buyQuotaRemaining`	Present when the token caps curve buys per wallet. `buyQuotaRemaining` needs `?wallet=`. A buy past the cap is filled up to it and the rest refunded.
`tax`	Only for tax tokens: how the tax splits (to the beneficiary, burned, paid to holders, added to liquidity), what has been paid out so far and what is waiting. See Creator Revenue.
`curve`	Flap's constant-product parameters `(x + h)(y + r) = k`, for anyone quoting off-chain. Immutable per token.

four.meme's OpenFour engine

A token launched through OpenFour, four.meme's modular engine, answers with protocol: "FOURMEME" and engine: "openfour" (classic four.meme tokens say engine: "classic"): its status (Tradable on the curve, SoldOut between filling and migrating, DEX once migrated), venue (openfour_curve or pancakeswap), quoteAsset, quoteReserve and graduationQuote (raised so far and the raise target), circulatingSupply and graduationSupply (sold so far and the sale allotment), totalSupply, progressPct, price (quote per token, 18-decimal fixed point) and marketCapFormatted, plus creator, presetId, paused, antiSniper and the module addresses (vault, curveModule, tradeModule, migrateModule). shrineFeeBps is 0 on this launchpad for now.

four.meme tokens

The same URL. A real four.meme token on its curve, priced in BNB:

{
  "protocol": "FOURMEME",
  "token": "0x118DfFa7f703d537C45f2453664219cbB9D1fFfF",
  "name": "mOOnkey",
  "symbol": "mOOnkey",
  "tokenType": "tax_v9",
  "isTaxToken": true,
  "status": "Tradable",
  "graduated": false,
  "venue": "fourmeme_curve",
  "managerVersion": 2,
  "tokenManager": "0x5c952063c7fc8610FFDB798152D69F0B9550762b",
  "quoteAsset": {
    "address": "0x0000000000000000000000000000000000000000",
    "symbol": "BNB",
    "decimals": 18,
    "isNative": true
  },
  "pairToken": "BNB",
  "bnbBuysAccepted": true,
  "quoteReserve": "1836538461535",
  "quoteReserveFormatted": "0.000001836538461535",
  "graduationQuote": "18000000000000000000",
  "graduationQuoteFormatted": "18",
  "circulatingSupply": "319965716672000000000",
  "circulatingSupplyFormatted": "319.965716672",
  "graduationSupply": "800000000000000000000000000",
  "graduationSupplyFormatted": "800000000",
  "progressPct": 0.0,
  "price": "5739799337",
  "curveFeeBps": 100,
  "currentBuyFeeBps": 99,
  "minTradingFee": "0",
  "minTradingFeeFormatted": "0",
  "antiSniper": false,
  "shrineFeeBps": 50,
  "buyTaxBps": 300,
  "sellTaxBps": 300,
  "launchTime": 1790125123,
  "launchBlock": 123474021,
  "walletBalance": "0",
  "walletBalanceFormatted": "0",
  "infoUri": "https://four.meme/meme-api/v1/private/token/get/v2?address=0x118dffa7f703d537c45f2453664219cbb9d1ffff"
}

Field	Meaning
`tokenType` / `isTaxToken`	`standard`, or one of four.meme's tax-token generations: `tax` (one rate on both sides), `tax_v8`, `tax_v9` (separate buy and sell rates, the current kind). A tax token charges `buyTaxBps` / `sellTaxBps` on every trade: on the curve it comes off the quote side, after graduation off the tokens as they move through the pair.
`status` / `graduated` / `venue`	`Tradable` while on the curve, `DEX` once graduated. `venue` is where a trade goes right now: `fourmeme_curve` or `pancakeswap`.
`managerVersion` / `tokenManager`	four.meme's manager holding the token: 2 for everything since September 2024, 1 for older tokens, which can be read but not traded on their curve.
`quoteAsset` / `pairToken`	What the curve is priced in: BNB, USDT, USD1 or one of Binance's tokenised stocks (BNCB, DJTB, QQQB, ...).
`bnbBuysAccepted`	Always `true`: four.meme's Helper swaps BNB into any quote asset on the way in.
`quoteReserve` / `graduationQuote`	Quote raised so far and the raise at which the curve graduates (18 BNB, or the equivalent in the quote asset). `progressPct` is the ratio; 100 once graduated.
`circulatingSupply` / `graduationSupply`	Tokens sold on the curve so far and the curve's whole allotment (800M).
`price`	Quote per token, 18-decimal fixed point, as four.meme reports it.
`curveFeeBps` / `currentBuyFeeBps` / `minTradingFee`	four.meme's base trading fee (1%), the fee a buy pays right now, and the minimum fee per trade. The two differ only on an anti-sniper token, where `currentBuyFeeBps` starts high and falls block by block after `launchBlock` - poll it and buy when it is back at the base.
`antiSniper`	Whether this launch has that opening fee schedule.
`shrineFeeBps`	Ours, 0.5%.
`launchTime` / `launchBlock`	When trading opened and the block the curve was created in.
`pool`	The PancakeSwap V2 pair, once graduated.
`walletBalance`	With `?wallet=`: that wallet's token balance.
`infoUri`	four.meme's own record of the token: image, description, socials, and its off-chain tax config.

Token​

four.meme's OpenFour engine​

four.meme tokens​

Token

four.meme's OpenFour engine

four.meme tokens