# Flap Trading API

> Trade and launch tokens on Flap, on BNB Chain

shrine.trade's free, keyless HTTP + WebSocket API for Flap - the launchpad on BNB Chain (chain id 56). Buy and sell any Flap token, on its bonding curve or in the PancakeSwap pool it graduates to; tax tokens included. Launch new tokens on Flap, standard or with a buy/sell tax. Every endpoint returns unsigned EIP-1559 transactions the caller signs and sends themselves; the API never holds keys or funds.

Key facts:

- Base URL: https://api.shrine.trade/bnb (WebSocket: wss://api.shrine.trade/bnb/api/launches/ws)
- Auth: none. Limits: 5 requests/second per IP per endpoint, 2 launch-feed connections per IP (HTTP 429 beyond).
- Amounts on a buy are BNB; tokens priced in USD1 or another asset are converted by Flap inside the transaction. Sells pay out BNB by default.
- Fee: 1% per trade to shrine.trade, taken in the asset the trade settles in. Launching and reads are free. Flap's own curve fee (1.25%) and the token's tax apply on top.
- Responses carry `txs`: sign each with the wallet in `from` and POST the signed hex to /api/send as `{ "signedTx" }`, in order - no RPC needed. Errors are `{ "error": code, "message": text }`.
- Full text of every page: https://shrine.trade/flap/llms-full.txt

## Docs

- [Flap API for Trading Bots on BNB Chain](https://shrine.trade/flap/index.md): Build bots that trade and launch tokens on Flap and PancakeSwap on BNB Chain through one free, keyless API. Buy, sell, stream every launch live, create tokens with a tax, collect creator revenue.
- [Create a Token on Flap (BNB Chain)](https://shrine.trade/flap/create-token.md): Launch a token on the Flap bonding curve on BNB Chain with one signed transaction - metadata, image, an optional buy and sell tax, a dev buy, and BNB, USD1 or a tokenised stock such as NVDAB or TSLAB as the quote.
- [Flap Creator Revenue](https://shrine.trade/flap/creator-fees.md): See what your Flap tax tokens have earned on BNB Chain and push anything waiting to your wallet. Tax is paid automatically; two endpoints cover the rest.
- [API Errors](https://shrine.trade/flap/errors.md): Every error code the Flap Trading API returns, grouped by endpoint, with what to do about each.
- [Frequently Asked Questions](https://shrine.trade/flap/faq.md): Answers about supported venues, fees, private-key safety, amounts, slippage, tax tokens, the live feed and rate limits for the Flap Trading API.
- [Fees](https://shrine.trade/flap/fees.md): shrine.trade charges 0.5% per trade on Flap tokens on BNB Chain, on the curve and on PancakeSwap; launching and reading are free. Flap's curve fee and a token's own tax apply on top.
- [Live Flap Launches on BNB Chain](https://shrine.trade/flap/live-launches.md): WebSocket feed of every new Flap launch and every graduation to PancakeSwap on BNB Chain, the moment it happens. Free and keyless.
- [Buy & Sell Flap Tokens on BNB Chain](https://shrine.trade/flap/local-trade.md): Buy or sell any Flap token on BNB Chain with one script, on the bonding curve or on PancakeSwap after graduation. Pay in BNB; tax tokens and USD1-priced tokens are handled for you.
- [Flap Token Info API](https://shrine.trade/flap/token-info.md): Read any Flap token on BNB Chain: curve progress, quote asset, buy and sell tax, per-wallet buy quota, PancakeSwap pool, and what the creator has earned.
- [BNB Chain Gas and Fees Explained](https://shrine.trade/flap/tutorials/bnb-chain-gas-and-fees.md): What BNB on BNB Chain pays for, what a trade or a launch actually costs, and why the wallet needs a little more than the trade amount.
- [How to Snipe Flap Launches on BNB Chain](https://shrine.trade/flap/tutorials/snipe-flap-launches.md): A complete Node.js bot that watches the Flap launch feed, filters on tax and quote asset, buys new tokens with BNB and sells at a target or a stop.
- [Trade Flap Tax Tokens Without Getting Burned](https://shrine.trade/flap/tutorials/trade-tax-tokens.md): How Flap tax tokens work on the curve and after graduation, what the buy and sell tax do to your fill, and how to read the numbers before you trade.