binance.com APIwww.binance.com ↗
Search Binance P2P marketplace ads via API. Get real-time prices, quantities, order limits, payment methods, and advertiser reputation for BUY and SELL listings.
curl -X POST 'https://api.parse.bot/scraper/dfbea875-2ec8-409d-b9bb-976b9274bf72/search_ads' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'Search P2P trading advertisements on Binance. Returns paginated listings of buy or sell offers with price, available quantity, order limits, accepted payment methods, and advertiser reputation. Results are sorted by price (best price first).
| Param | Type | Description |
|---|---|---|
| fiat | string | Fiat currency code (e.g. USD, EUR, GBP, NGN, INR, BRL, TRY). |
| page | integer | Page number for pagination, starting at 1. |
| rows | integer | Number of results per page, between 1 and 20. |
| asset | string | Cryptocurrency asset to trade. Common values: USDT, BTC, USDC, FDUSD, BNB, ETH, TRUMP, 1000CHEEMS, TST. |
| pay_type | string | Filter by payment method identifier (e.g. Wise, BANK, SEPAinstant, BankofGeorgia, TBCbank). When omitted, all payment methods are included. |
| trade_type | string | Trade direction. Accepts exactly: BUY, SELL. BUY shows ads from sellers (you buy crypto), SELL shows ads from buyers (you sell crypto). |
| trans_amount | string | Filter ads that accept this transaction amount in fiat (e.g. '500'). Only ads whose min/max range includes this amount are returned. |
| publisher_type | string | Filter by publisher type. Use 'merchant' for verified merchants only, or empty string for all advertisers. |
{
"type": "object",
"fields": {
"ads": "array of advertisement objects with price, quantity, limits, payment methods, and advertiser info",
"page": "integer current page number",
"rows": "integer results per page",
"total": "integer total number of matching ads"
},
"sample": {
"ads": [
{
"fiat": "USD",
"ad_id": "13865122043880517632",
"asset": "USDT",
"price": "1.096",
"advertiser": {
"nickname": "Isrrakeko",
"user_type": "merchant",
"is_blocked": false,
"positive_rate": 0.99903834,
"month_finish_rate": 1,
"month_order_count": 1849
},
"trade_type": "SELL",
"fiat_symbol": "$",
"trade_methods": [
{
"name": "Banco Pichincha",
"identifier": "BancoPichincha"
}
],
"tradable_quantity": "3505.41",
"pay_time_limit_minutes": 15,
"max_single_trans_amount": "480",
"min_single_trans_amount": "99"
}
],
"page": 1,
"rows": 10,
"total": 769
}
}About the binance.com API
The Binance P2P API exposes 1 endpoint — search_ads — that returns paginated listings of peer-to-peer cryptocurrency trading advertisements across fiat currencies and crypto assets. Each ad object includes the current price, available quantity, min/max order limits, accepted payment methods, and advertiser reputation data. Results are sorted best-price-first, making it straightforward to compare rates across sellers or buyers in a given market.
What the API Returns
The search_ads endpoint returns an array of P2P advertisement objects from Binance's marketplace. Each object carries the advertised price in fiat, the available quantity of the crypto asset, the minimum and maximum order limits the advertiser accepts, a list of accepted payment method identifiers, and advertiser profile data including reputation signals. The response also includes pagination metadata: page, rows, and total.
Filtering Ads
You can narrow results using several optional parameters. asset controls which cryptocurrency you're looking at — common values include USDT, BTC, ETH, USDC, and BNB. fiat sets the fiat currency side (USD, EUR, NGN, INR, BRL, TRY, and others). trade_type accepts exactly BUY or SELL: BUY returns ads posted by sellers (people you can buy from), SELL returns ads posted by buyers. pay_type filters by a specific payment method identifier such as Wise, BANK, SEPAinstant, or a named bank like TBCbank. The trans_amount parameter filters to ads whose min/max fiat range includes a specific transaction size, which helps avoid ads you can't fill.
Pagination and Publisher Filtering
Results come back in pages. Set page (starting at 1) and rows (1–20) to page through the full result set. The total field in the response tells you how many matching ads exist. The publisher_type parameter lets you restrict results to verified Binance merchants by passing merchant, or leave it empty to see all advertisers. This is useful when building applications that prioritize counterparty trust.
Coverage Scope
The API covers the public P2P ad listings — price, quantity, limits, payment methods, and advertiser reputation — for any supported fiat/asset pair. It does not return individual trade history, completed order data, or private account information. Rate and availability data reflects the live public ad board.
- Monitor USD/USDT P2P rates across payment methods to detect arbitrage windows between Binance P2P and spot markets.
- Build a rate aggregator showing the best BUY and SELL prices for a given fiat/crypto pair filtered by payment method.
- Track NGN or TRY P2P premiums as a proxy for local exchange rate pressure in restricted-currency markets.
- Filter merchant-only ads to surface counterparties with verified status for a higher-trust trading interface.
- Alert when a P2P ad accepting SEPAinstant drops below a target price threshold for a given fiat/crypto pair.
- Analyze advertiser reputation distributions across price tiers to study P2P market microstructure.
- Paginate through all available USDT/BRL sell ads to compute a volume-weighted average P2P rate.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Binance have an official developer API?+
What does the `trade_type` parameter actually control?+
trade_type: BUY returns ads posted by sellers — advertisers willing to sell crypto to you in exchange for fiat. trade_type: SELL returns ads posted by buyers — advertisers willing to buy crypto from you. The naming reflects your action, not the advertiser's.Does the API return completed trade history or order-level data?+
How does pagination work, and is there a limit on results per page?+
page to the desired page number starting at 1, and rows to a value between 1 and 20. The response includes a total field with the count of matching ads, so you can calculate how many pages exist. Requests for more than 20 rows per page are not supported by the endpoint.