ShrineAPI

BNB Chain

four.meme and Flap.
Curve to PancakeSwap.

Send a token address and an amount. The API works out whether it is a Flap or a four.meme token and where it trades, on its bonding curve or in the PancakeSwap pool it graduated to, and hands back the transactions for your wallet to sign. You pay in BNB, whatever the token is priced in. Launch on Flap and stream every launch and trade through the same API.

No account and no key. 0.5% per buy or sell; launching and reading are free.

01How it works

Quote, sign, broadcast.

One request returns the quote and the transactions to sign. Your script signs them and hands the signed bytes back to be broadcast, so you need no RPC of your own.

  • Ask for a trade.A token address, an amount, slippage and your wallet. On a buy the amount is BNB; on a sell it is a token count, or a share of your balance such as "100%".
  • Read the quote.expectedOut is what you end up with once the launchpad's fee, the token's tax and ours are taken. minOut is the floor the contract enforces.
  • Sign and send.Sign the transactions in txs in order: a buy is one, a token's first sell is two, a one-time approval and the sell. /api/send broadcasts them through our own endpoint, not a public node.
Buy & Sell docs
A buy on BNB ChainJavaScriptfrom the docs
const wallet = new Wallet(PRIVATE_KEY); // signs only; no node needed

// 1. Ask for the quote and the transactions to sign.
const res = await fetch("https://api.shrine.trade/bnb/api/local-trade", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    action: "buy",        // "buy" or "sell"
    token: "0xTHE_TOKEN_ADDRESS",
    amount: "0.01",       // to buy: BNB. To sell: "1000" tokens, or "100%"
    slippage: 5,          // %, how far the price may move against you
    from: wallet.address,
  }),
});
const data = await res.json();

// 2. Sign locally, 3. hand the signed bytes to the API to broadcast.
for (const tx of data.txs) {
  const signed = await wallet.signTransaction({
    to: tx.to, data: tx.data, value: BigInt(tx.value),
    gasLimit: BigInt(tx.gas), maxFeePerGas: BigInt(tx.maxFeePerGas),
    maxPriorityFeePerGas: BigInt(tx.maxPriorityFeePerGas),
    nonce: tx.nonce, chainId: tx.chainId, type: 2,
  });
  await fetch("https://api.shrine.trade/bnb/api/send", {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify({ signedTx: signed }),
  });
}
// a real response from the docs, trimmed: a tax token on its curve
{
  "protocol": "FLAP",
  "status": "Tradable",
  "venue": "flap_curve",
  "payWith": "BNB",
  "quote": {
    "expectedOutFormatted": "160442.982903129676642962",
    "curveFeeBps": 125,
    "creatorTaxBps": 1000,
    "shrineFeeBps": 50,
    "slippagePct": 5.0
  },
  "txs": [{ "gas": 521904, "chainId": 56, "description": "buy", … }]
}

02Launchpads

Curve or pool. One request.

You send the token address. The API asks both launchpads whose it is, reads its state and routes it, before and after graduation. Tax tokens need no special handling: the tax is already inside the quote.

Flapbonding curve, until 800M tokens are sold
four.memebonding curve, until the raise is complete
OpenFourfour.meme's modular engine
PancakeSwapafter graduation
Uniswap v4when someone pooled a token there
Quoted tokenspriced in USD1 or a stock, bought with BNB

03Products

What runs on BNB Chain.

On BNB Chain, Shrine runs the Trading API and two WebSocket streams, every endpoint open with no key or account. Each card links to its page in the docs.

Buy and sell

Any Flap or four.meme token, on its bonding curve or in its PancakeSwap pool after graduation, for BNB. Tax tokens and tokens priced in USDT, USD1 or a stock are handled for you.

Buy & Sell

Create a token

Launch on Flap, standard or with a tax, with the metadata pinned, the vanity address Flap requires and an optional dev buy in the same transaction. No fee on creation.

Create Token

Creator revenue

See what your tax tokens have earned and what is still waiting, and get the transactions that push it to your wallet.

Creator Revenue

Live launches

Every Flap and four.meme launch and every graduation to PancakeSwap, the moment it happens, with the tax and the quote asset on the event.

Live Launches

Advanced Data Stream

Every buy and sell on the curves and in the PancakeSwap and Uniswap v4 pools after graduation, plus launches and graduations, each trade with its price and market cap.

Advanced Data Stream

Token info

Curve progress, quote asset, buy and sell tax, a wallet's buy quota and the anti-sniper fee, to size a buy before you trade.

Token Info

04Fees

No plan to pick. 0.5% a trade.

No account, no API key and no rate plan. A buy or a sell pays 0.5%, charged in the settlement asset. Everything else is free.

FeeLimit per IP
Buyon the curve or on PancakeSwap0.5%3 req/s
Sellon the curve or on PancakeSwap0.5%3 req/s
Create tokenFree3 req/s
Token infoFree3 req/s
Live launch feedFree1 socket
Advanced Data StreamFree1 socket

The launchpad's curve fee (Flap 1.25%, four.meme 1%) and a token's tax apply on top. Buys and sells share one endpoint and its limit. For a lower fee on real size, ask on Telegram. The details are on Fees.

05FAQ

Questions, answered.

Anything else is in the docs FAQ.

Do I need an API key or an account?

No. Every endpoint is open. Two limits apply per IP address: 3 requests a second on any one endpoint, and one open launch-feed socket.

Is my private key safe?

It never leaves your machine. Every response is an unsigned transaction. Signing happens in your script, with your key, and only the signed bytes are posted to /api/send, which broadcasts them and can do nothing else with them.

What does it cost?

A 0.5% fee on buys and on sells, charged in the settlement asset. Token info, the launch feed and creating a token cost nothing. The launchpad's own curve fee (Flap 1.25%, four.meme 1%) and the token's tax apply on top, and gas is a fraction of a cent.

Which currency is amount in?

On a buy, BNB, whatever the token is priced in: the launchpad swaps into USDT, USD1 or whichever asset the token uses on the way. On a sell, tokens, or a percentage of your balance like "50%". Flap sells pay out BNB; four.meme sells pay out the asset the token is priced in.

When can I buy a new launch?

On Flap, immediately: it has no opening snipe tax, only optional per-wallet buy caps and the token's own tax, both visible in the quote. On four.meme, a launch flagged antiSniper in the feed charges a trading fee that starts high and falls block by block. Poll currentBuyFeeBps in Token Info and buy when it is back at 100 (1%), or accept the fee for the head start.

No account and no key. 0.5% per buy or sell, launching and reading free.