# P2P Street Rates API
> Live crypto peer-to-peer street rates from the Binance P2P marketplace. On P2P, people buy and sell USDT (a USD proxy) directly for local currency, so the advertised prices reveal the REAL street value of a currency — for stressed currencies (Argentine peso, Venezuelan bolívar, Nigerian naira and more) this is the rate the economy actually transacts at, far from the official one. The rate endpoint returns the best buy and sell P2P price for an asset in a fiat, the mid and the spread. The ads endpoint returns the live order book of P2P advertisements — price, available amount, order limits, merchant reputation and payment methods. The fiats endpoint lists supported currencies. Read live from Binance P2P, nothing stored. This is the crypto-P2P street-rate and merchant-ad layer — distinct from official FX feeds and from crypto-arbitrage-implied rates.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/p2prates-api/..."
```

## Pricing
- **Free** (Free) — 2,700 calls/Mo, 2 req/s
- **Starter** ($7/Mo) — 75,000 calls/Mo, 12 req/s
- **Pro** ($22/Mo) — 380,000 calls/Mo, 35 req/s
- **Scale** ($51/Mo) — 2,400,000 calls/Mo, 110 req/s

## Endpoints

### Rate

#### `GET /v1/rate` — Best buy/sell P2P price, mid and spread

**Parameters:**
- `fiat` (query, required, string) — Fiat currency code Example: `ARS`
- `asset` (query, optional, string) — Crypto asset (USDT default, BTC, ETH …) Example: `USDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/p2prates-api/v1/rate?fiat=ARS&asset=USDT"
```

**Response:**
```json
{
    "data": {
        "fiat": "ARS",
        "note": "Price = fiat per 1 USDT; for USDT this approximates the street USD rate.",
        "asset": "USDT",
        "source": "Binance P2P",
        "buy_price": 1500,
        "fiat_name": "Argentine Peso",
        "mid_price": 1498.5,
        "buy_median": 1501.88,
        "sell_price": 1497,
        "spread_pct": 0.2002,
        "sell_median": 1496.72,
        "total_buy_ads": 251,
        "total_sell_ads": 417
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:55.493Z",
        "request_id": "279b2112-1132-495d-8e2c-ce6f721ace60"
    },
    "status": "ok",
    "message": "Rate retrieved successfully",
    "success": true
}
```

### Ads

#### `GET /v1/ads` — Live P2P advertisements for a fiat

**Parameters:**
- `fiat` (query, required, string) — Fiat currency code Example: `ARS`
- `type` (query, optional, string) — buy (default) or sell Example: `buy`
- `asset` (query, optional, string) — Crypto asset Example: `USDT`
- `limit` (query, optional, string) — Max ads (1-20) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/p2prates-api/v1/ads?fiat=ARS&type=buy&asset=USDT&limit=10"
```

**Response:**
```json
{
    "data": {
        "ads": [
            {
                "price": 1500,
                "merchant": "SirCharls",
                "orders_30d": 2,
                "max_order_fiat": 3667664,
                "min_order_fiat": 3004440,
                "available_asset": 2445.1,
                "payment_methods": [
                    "Mercadopago",
                    "Naranja X"
                ],
                "completion_rate_pct": 100
            },
            {
                "price": 1501,
                "merchant": "CryptoG",
                "orders_30d": 17,
                "max_order_fiat": 324617,
                "min_order_fiat": 324300,
                "available_asset": 216.26,
                "payment_methods": [
                    "Mercadopago",
                    "Bank Transfer (Argentina)",
                    "Uala"
                ],
                "completion_rate_pct": 100
            },
            {
                "price": 1501.88,
                "merchant": "SalanovoA",
                "orders_30d": 387,
                "max_order_fiat": 2609374,
                "min_order_fiat": 10000,
                "available_asset": 1737.4,
                "payment_methods": [
                    "Mercadopago",
                    "Lemon Cash",
                    "Bank Transfer (Argentina)",
                    "Naranja X",
                    "Banco Brubank"
                ],
                "completion_rate_pct": 100
            },
            {
  
…(truncated, see openapi.json for full schema)
```

### Fiats

#### `GET /v1/fiats` — Supported fiat currencies and assets

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/p2prates-api/v1/fiats"
```

**Response:**
```json
{
    "data": {
        "count": 31,
        "fiats": [
            {
                "code": "ARS",
                "name": "Argentine Peso"
            },
            {
                "code": "VES",
                "name": "Venezuelan Bolívar"
            },
            {
                "code": "NGN",
                "name": "Nigerian Naira"
            },
            {
                "code": "COP",
                "name": "Colombian Peso"
            },
            {
                "code": "BRL",
                "name": "Brazilian Real"
            },
            {
                "code": "RUB",
                "name": "Russian Ruble"
            },
            {
                "code": "INR",
                "name": "Indian Rupee"
            },
            {
                "code": "TRY",
                "name": "Turkish Lira"
            },
            {
                "code": "USD",
                "name": "US Dollar"
            },
            {
                "code": "EUR",
                "name": "Euro"
            },
            {
                "code": "GBP",
                "name": "British Pound"
            },
            {
                "code": "UAH",
                "name": "Ukrainian Hryvnia"
            },
            {
                "code": "PKR",
                "name": "Pakistani Rupee"
            },
            {
                "code": "EGP",
                "name": "Egyptian Pound"
            },
            {
                "code": "KZT
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/p2prates-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Binance P2P (p2p.binance.com, live)",
        "service": "p2prates-api",
        "endpoints": {
            "GET /v1/ads": "Live P2P advertisements — price, limits, merchant, payment methods (fiat=ARS, type=buy, asset=USDT).",
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "Best buy/sell P2P price, mid and spread for an asset in a fiat (fiat=ARS, asset=USDT).",
            "GET /v1/fiats": "Supported fiat currencies and assets."
        },
        "description": "Live crypto peer-to-peer street rates from the Binance P2P marketplace. On P2P, people buy and sell USDT (a USD proxy) directly for local currency, so the advertised prices reveal the real street value of a currency — for stressed currencies (Argentine peso, Venezuelan bolívar, Nigerian naira …) this is the rate the economy actually transacts at, far from the official one. The rate endpoint returns the best buy and sell P2P price for an asset in a fiat, the mid and the spread; the ads endpoint returns the live order book of P2P advertisements (price, available amount, order limits, merchant reputation, payment methods); the fiats endpoint lists supported currencies. Live, no key, nothing stored. Distinct from official FX feeds and from crypto-arbitrage-implied rates — this is the crypto-P2P street-rate and merchant-ad layer.",
        "usdt_ars_mid": 1498.5,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T22:5
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/p2prates-api
OpenAPI spec: https://www.oanor.com/api/p2prates-api/openapi.json