{"uid":"cap_uzUvVXbWblhm7nltmpDyy","slug":"bsc-bnb-chain-dex-cross-exchange-arbitrage-price-feed-api-1e549b9b","name":"BSC/BNB Chain DEX Cross-Exchange Arbitrage & Price Feed API","description":"Cross-DEX price, liquidity and gross arbitrage spread for ONE BSC pair in a single call, across PancakeSwap v2/v3, Biswap and ApeSwap. Returns pricesByVenue[], bestBuy, bestSell, midSpreadBps, crossDex (grossSpreadBps, grossUsd, optimalInput) and liquidity at a stated blockNumber. Requires ?pair=SYM/SYM (first symbol is USD-priceable); optional ?fee= pins one v3 tier. Errors: 400 bad_pair|bad_fee, 404 no_pools, 502 upstream_read_failed. Split views: /price, /liquidity, /route.","url":"https://x402.donnyautomation.com/call","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["pair"],"properties":{"fee":{"type":"string","description":"Optional PancakeSwap v3 fee tier to restrict the v3 probe (e.g. 100, 500, 2500, 10000). Omit to probe all v3 tiers + v2."},"pair":{"type":"string","description":"Token pair as SYM/SYM; first symbol is the USD-priceable side (e.g. WBNB/USDC, WBNB/USDT, CAKE/WBNB)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ts":"2026-07-01T00:00:00.000Z","pair":"WBNB/USDC","source":"rpc","bestBuy":{"price":546.2,"venue":"pancakeV3:500"},"chainId":56,"network":"bsc","bestSell":{"price":546.9,"venue":"pancake"},"crossDex":{"surface":"v2v3","buyVenue":"pancakeV3:500","grossUsd":3.2,"sellVenue":"pancake","optimalInput":{"usd":1148,"token":"WBNB","amount":2.1},"grossSpreadBps":14.05,"tickBoundaryBreach":false},"liquidity":{"venues":7,"totalTvlUsd":9800000},"nativeUsd":546.6,"blockNumber":107399076,"midSpreadBps":27.4,"pricesByVenue":[{"price":546.6,"venue":"pancake","feeBps":25,"tvlUsd":1348000,"surface":"v2"},{"price":546.2,"venue":"pancakeV3:500","feeBps":5,"tvlUsd":2100000,"surface":"v3"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nYanYhXRuKETnVn-7QPYH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time on-chain token pair prices, liquidity/TVL, and cross-exchange arbitrage spreads across PancakeSwap v2/v3, Biswap, and ApeSwap on BSC in a single call","exampleAgentPrompt":"Pull live cross-DEX prices and arbitrage spread for WBNB/USDC across PancakeSwap v2, PancakeSwap v3, Biswap, and ApeSwap on BNB Chain right now, and tell me the best buy-sell quotes and gross spread in bps.","exampleUseCases":[{"title":"Arbitrage bot opportunity scanner","prompt":"Check the current cross-exchange arbitrage spread for WBNB/USDC across all BSC DEXes — PancakeSwap v2, v3, Biswap, and ApeSwap — and tell me the gross spread in basis points and USD, plus the optimal trade size."},{"title":"DeFi agent price oracle lookup","prompt":"I need the live on-chain price of CAKE/WBNB on BNB Chain aggregated across all major DEXes, including TVL and liquidity at each venue, so I can use it as a price oracle reference."},{"title":"PancakeSwap v3 fee tier comparison","prompt":"Fetch the best buy-sell quote for WBNB/USDT on PancakeSwap v3 using the 500 bps fee tier on BSC and return the current block number with the price."}],"resultDescription":"Returns a structured JSON response containing: per-venue price feed for each DEX (PancakeSwap v2, PancakeSwap v3 per fee tier, Biswap, ApeSwap), best buy and sell quotes, gross arbitrage spread in basis points and USD, optimal trade size, current liquidity/TVL per venue, and the on-chain block number at time of query.","failureModes":["Invalid or unrecognized token pair symbol returns an error — pair must be formatted as SYM/SYM with a USD-priceable first token","Unsupported fee tier value for PancakeSwap v3 returns an error — valid tiers are 100, 500, 2500, 10000","No liquidity found for a pair on one or more venues — response may omit that venue or return zero","Payment failure or insufficient USDC balance results in 402 Payment Required with no data returned","Network issues or BSC node lag may cause stale block number or timeout"],"whenToPreferThis":"Choose this endpoint when you need real-time, multi-venue DEX price aggregation and arbitrage spread calculation specifically on BNB Chain/BSC in a single API call. It is ideal for trading bots, DeFi agents, and price oracles that need to compare PancakeSwap v2, PancakeSwap v3 (all fee tiers), Biswap, and ApeSwap simultaneously without building separate integrations. Prefer this over generic crypto price APIs when you need on-chain liquidity/TVL data and arbitrage-grade spread precision (bps + USD) rather than just a spot price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:38.034Z","isFirstParty":false}