# Binance — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse peer-to-peer cryptocurrency trading offers on Binance's marketplace to find the best prices, payment methods, and seller information for buying or selling crypto directly. Get real-time details on available quantities, rates, and advertiser profiles to make informed trading decisions.

**Category:** Web3 & Onchain | **Website:** [www.binance.com/en](https://www.binance.com/en) | **Docs:** [parse.bot/marketplace/2ba036f7-b79d-4bab-84dd-5cb78d0aa795/binance-com-api](https://parse.bot/marketplace/2ba036f7-b79d-4bab-84dd-5cb78d0aa795/binance-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-binance-com-api-2ba036f7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### search_ads

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset` | string | No | Cryptocurrency asset to trade. Common values: USDT, BTC, USDC, FDUSD, BNB, ETH. |
| `fiat` | string | No | Fiat currency code (e.g. USD, EUR, GBP, NGN, INR, BRL, TRY). |
| `page` | integer | No | Page number for pagination, starting at 1. |
| `pay_type` | string | No | Filter by payment method identifier (e.g. Wise, BANK, SEPAinstant). When omitted, all payment methods are included. |
| `publisher_type` | string | No | Filter by publisher type. Use 'merchant' for verified merchants only, or empty string for all advertisers. |
| `rows` | integer | No | Number of results per page, between 1 and 20. |
| `trade_type` | string | No | Trade direction. Accepts exactly: BUY, SELL. |
| `trans_amount` | string | No | Filter ads that accept this transaction amount in fiat (e.g. '500'). Only ads whose min/max range includes this amount are returned. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-binance-com-api-2ba036f7/search_ads \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset":"<string>","fiat":"<string>","page":"<integer>","pay_type":"<string>","publisher_type":"<string>","rows":"<integer>","trade_type":"<string>","trans_amount":"<string>"}'
```