Binance APIbinance.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.
What is the Binance 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.
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 '{
"fiat": "USD",
"page": "1",
"rows": "5",
"asset": "USDT",
"trade_type": "BUY",
"publisher_type": "merchant"
}'Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace binance-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.binance_p2p_prices_api import BinanceP2P, Ad, TradeType
client = BinanceP2P()
# Search for USDT buy offers in USD from verified merchants
for ad in client.ads.search(asset="USDT", fiat="USD", trade_type=TradeType.BUY, limit=5):
print(ad.ad_id, ad.price, ad.tradable_quantity, ad.advertiser.nickname, ad.advertiser.positive_rate)
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). BUY shows ads from sellers (you buy crypto), SELL shows ads from buyers (you sell crypto). Paginates via integer page number; each page returns up to `rows` results.
| 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. |
| pay_type | string | Filter by payment method identifier (e.g. Wise, BANK, SEPAinstant). When omitted, all payment methods are included. |
| trade_type | string | Trade direction. Accepts exactly: BUY, SELL. |
| 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": {
"data": {
"ads": [
{
"fiat": "USD",
"ad_id": "13865122043880517632",
"asset": "USDT",
"price": "1.098",
"advertiser": {
"nickname": "Isrrakeko",
"user_type": "merchant",
"is_blocked": false,
"positive_rate": 0.99881712,
"month_finish_rate": 1,
"month_order_count": 1908
},
"trade_type": "SELL",
"fiat_symbol": "$",
"trade_methods": [
{
"name": "Banco Pichincha",
"identifier": "BancoPichincha"
}
],
"tradable_quantity": "3407.86",
"pay_time_limit_minutes": 15,
"max_single_trans_amount": "440",
"min_single_trans_amount": "10"
}
],
"page": 1,
"rows": 5,
"total": 929
},
"status": "success"
}
}About the Binance API
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.
The Binance API is a managed, monitored endpoint for binance.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when binance.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official binance.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.