Skip to main content

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…
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.

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"
  }
}
FieldMeaning
tokenType / isTaxTokenstandard 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 / venueFlap's Tradable while on the curve, DEX once graduated. venue is where a trade goes right now: flap_curve or pancakeswap.
quoteAsset / pairTokenWhat 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.
bnbBuysAcceptedtrue 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 / circulatingSupplyHow much quote the curve holds and how many tokens it has sold.
graduationSupply / progressPctThe curve graduates to PancakeSwap once circulatingSupply reaches graduationSupply (800M on BNB Chain). progressPct is how far along it is; 100 once graduated.
priceQuote per token, 18-decimal fixed point, as Flap's Portal reports it.
curveFeeBps / shrineFeeBpsFlap's fee on curve trades (0 after graduation) and ours (0.5%).
poolThe PancakeSwap pool, once graduated.
maxBuyPerWallet / buyQuotaRemainingPresent 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.
taxOnly 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.
curveFlap's constant-product parameters (x + h)(y + r) = k, for anyone quoting off-chain. Immutable per token.

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"
}
FieldMeaning
tokenType / isTaxTokenstandard, 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 / venueTradable while on the curve, DEX once graduated. venue is where a trade goes right now: fourmeme_curve or pancakeswap.
managerVersion / tokenManagerfour.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 / pairTokenWhat the curve is priced in: BNB, USDT, USD1 or one of Binance's tokenised stocks (BNCB, DJTB, QQQB, ...).
bnbBuysAcceptedAlways true: four.meme's Helper swaps BNB into any quote asset on the way in.
quoteReserve / graduationQuoteQuote 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 / graduationSupplyTokens sold on the curve so far and the curve's whole allotment (800M).
priceQuote per token, 18-decimal fixed point, as four.meme reports it.
curveFeeBps / currentBuyFeeBps / minTradingFeefour.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.
antiSniperWhether this launch has that opening fee schedule.
shrineFeeBpsOurs, 0.5%.
launchTime / launchBlockWhen trading opened and the block the curve was created in.
poolThe PancakeSwap V2 pair, once graduated.
walletBalanceWith ?wallet=: that wallet's token balance.
infoUrifour.meme's own record of the token: image, description, socials, and its off-chain tax config.