{
  "what": "Free REST tools for trading bots on BNB Smart Chain: measure a token before you trade it — can you get in, can you get out, what the round trip costs at your size. Every route is a GET and answers JSON.",
  "start": "Before every buy: GET https://brainonbnb.com/api/preflight?address=<token>&usd=<your size> and branch on gate: \"stop\" (do not trade, stop[] says why), \"weigh\" (caution[] with figures), \"no_known_stop\".",
  "limits": {
    "key": "none — no key, no sign-up; CORS open",
    "free": "every route free; /api/pool-scan alone counts: 1,000 per caller and UTC day, past that HTTP 402 or 429 with code free_limit",
    "day_pass": "past the free pool scans: POST https://agent.brainonbnb.com/scan-pass — 0.50 USD1, half that in $BOBAI, free for a wallet holding 1,000,000 $BOBAI; then send header X-Scan-Pass (2,000 scans a pass)",
    "cache": "pool figures are never cached (Cache-Control: no-store); GoPlus contract flags and holder lists up to 6 h"
  },
  "trading": [
    {
      "path": "/api/preflight",
      "does": "Before every buy: can you get in and out at your size, what the round trip costs with the measured tax, who controls the contract. Branch on gate: stop | weigh | no_known_stop.",
      "params": [
        {
          "name": "address",
          "required": true,
          "type": "string",
          "about": "A BSC token address, a pool/pair address, or a link containing one"
        },
        {
          "name": "usd",
          "required": false,
          "type": "number",
          "about": "Trade size in dollars, optional - defaults to 250"
        }
      ],
      "example": "https://brainonbnb.com/api/preflight?address=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82&usd=250",
      "mcp_tool": "bsc_token_preflight"
    },
    {
      "path": "/api/pool-scan",
      "does": "The full read behind the preflight: cost per size, 1% depth both ways, measured tax, sell simulation, LP custody, holders, flow, every venue.",
      "params": [
        {
          "name": "address",
          "required": true,
          "type": "string",
          "about": "A BSC token address, a pool/pair address, or any BscScan / DexScreener / PancakeSwap link containing one"
        }
      ],
      "example": "https://brainonbnb.com/api/pool-scan?address=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82",
      "mcp_tool": "bsc_pool_scan"
    },
    {
      "path": "/api/best-route",
      "does": "Which PancakeSwap pool returns the most at your size (quoted by the venue), every other route, the round trip with the tax, the slippage it needs.",
      "params": [
        {
          "name": "address",
          "required": true,
          "type": "string",
          "about": "A BSC token address, or a PancakeSwap pool address to pin the pair"
        },
        {
          "name": "usd",
          "required": false,
          "type": "number",
          "about": "Trade size in dollars, optional - defaults to 250"
        }
      ],
      "example": "https://brainonbnb.com/api/best-route?address=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82&usd=250",
      "mcp_tool": "pancakeswap_best_route"
    },
    {
      "path": "/api/fee-tiers",
      "does": "For liquidity: which fee tier of a pair actually pays, fees per $1,000 over all capital and over the capital within 2% of the price.",
      "params": [
        {
          "name": "address",
          "required": true,
          "type": "string",
          "about": "A BSC token address (all of its PancakeSwap pools against its main quote are compared), or one PancakeSwap pool address to pin that exact pair; 0x + 40 hex"
        }
      ],
      "example": "https://brainonbnb.com/api/fee-tiers?address=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82",
      "mcp_tool": "pancakeswap_fee_tiers"
    },
    {
      "path": "/api/range-plan",
      "does": "For a V3 position: each range width replayed through the real swaps of the last hour — fees, time in range, exits. No forecast.",
      "params": [
        {
          "name": "address",
          "required": true,
          "type": "string",
          "about": "A BSC token address, or a PancakeSwap V3 pool address to pin the pool"
        },
        {
          "name": "capitalUsd",
          "required": false,
          "type": "number",
          "about": "Size of the position in dollars, optional - defaults to 1000. It sets your share of the active liquidity at each swap, so the fees depend on it"
        },
        {
          "name": "quote",
          "required": false,
          "type": "string",
          "about": "The other side of the pair, optional: BNB, USDT, USDC, USD1 or BUSD, or its address. Without it the quote with the deepest V3 pool is used, so pass it whenever a pair was named (CAKE/BNB)"
        }
      ],
      "example": "https://brainonbnb.com/api/range-plan?address=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82&capitalUsd=1000&quote=BNB",
      "mcp_tool": "pancakeswap_range_plan"
    }
  ],
  "bobai": [
    "/api/activity",
    "/api/circulating-supply",
    "/api/dex-info",
    "/api/guide",
    "/api/how-to-buy",
    "/api/links",
    "/api/liquidity",
    "/api/nft-drop",
    "/api/nft/state",
    "/api/price",
    "/api/purchase-guide",
    "/api/smart-money",
    "/api/token",
    "/api/tokenomics",
    "/api/total-supply",
    "/api/trade",
    "/api/wallet"
  ],
  "openapi": "https://brainonbnb.com/openapi.json",
  "alarm": "Hold a token? bsc_rug_watch POSTs your webhook when it turns dangerous (one watch free): https://agent.brainonbnb.com/rug-watch",
  "docs": "https://brainonbnb.com/llms.txt",
  "mcp": "https://brainonbnb.com/mcp"
}