{"openapi":"3.1.0","info":{"title":"P2P Street Rates API","version":"1.0.0","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 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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/p2prates-api","description":"oanor gateway"}],"tags":[{"name":"Rate"},{"name":"Ads"},{"name":"Fiats"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/rate":{"get":{"operationId":"get_v1_rate","tags":["Rate"],"summary":"Best buy/sell P2P price, mid and spread","description":"","parameters":[{"name":"fiat","in":"query","required":true,"description":"Fiat currency code","schema":{"type":"string"},"example":"ARS"},{"name":"asset","in":"query","required":false,"description":"Crypto asset (USDT default, BTC, ETH …)","schema":{"type":"string"},"example":"USDT"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/ads":{"get":{"operationId":"get_v1_ads","tags":["Ads"],"summary":"Live P2P advertisements for a fiat","description":"","parameters":[{"name":"fiat","in":"query","required":true,"description":"Fiat currency code","schema":{"type":"string"},"example":"ARS"},{"name":"type","in":"query","required":false,"description":"buy (default) or sell","schema":{"type":"string"},"example":"buy"},{"name":"asset","in":"query","required":false,"description":"Crypto asset","schema":{"type":"string"},"example":"USDT"},{"name":"limit","in":"query","required":false,"description":"Max ads (1-20)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},{"price":1501.89,"merchant":"Crypto_Cori","orders_30d":379,"max_order_fiat":80000,"min_order_fiat":8000,"available_asset":343.36,"payment_methods":["Uala","Naranja X","Banco Santander Argentina"],"completion_rate_pct":100},{"price":1501.9,"merchant":"tinoP2P","orders_30d":281,"max_order_fiat":51906,"min_order_fiat":50000,"available_asset":34.56,"payment_methods":["Mercadopago","Uala","Lemon Cash","Naranja X","Fiwind"],"completion_rate_pct":100},{"price":1501.9,"merchant":"monita111","orders_30d":299,"max_order_fiat":150000,"min_order_fiat":15000,"available_asset":299.4,"payment_methods":["Belo app","Naranja X","Bank Transfer (Argentina)"],"completion_rate_pct":100},{"price":1501.91,"merchant":"Monocrypto7","orders_30d":213,"max_order_fiat":901188,"min_order_fiat":7840,"available_asset":600.08,"payment_methods":["Naranja X","Lemon Cash","Banco Brubank","Uala","Belo app"],"completion_rate_pct":99.6},{"price":1501.92,"merchant":"MaxRey123","orders_30d":73,"max_order_fiat":4515847,"min_order_fiat":1500000,"available_asset":3006.71,"payment_methods":["Lemon Cash","Personal Pay"],"completion_rate_pct":98.7},{"price":1501.94,"merchant":"Chicharritaaa","orders_30d":203,"max_order_fiat":343887,"min_order_fiat":50000,"available_asset":228.96,"payment_methods":["Bank Transfer (Argentina)","Lemon Cash","Mercadopago","Naranja X","Banco Brubank"],"completion_rate_pct":95.8},{"price":1501.96,"merchant":"Jheferson1001","orders_30d":928,"max_order_fiat":264581,"min_order_fiat":10000,"available_asset":176.15,"payment_methods":["Mercadopago"],"completion_rate_pct":98.7}],"fiat":"ARS","type":"buy","asset":"USDT","count":10,"source":"Binance P2P","fiat_name":"Argentine Peso","total_ads":251},"meta":{"timestamp":"2026-06-10T22:56:55.862Z","request_id":"3ac3a85d-55e2-4b6c-bc34-54f7c54fe2fc"},"status":"ok","message":"Ads retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/fiats":{"get":{"operationId":"get_v1_fiats","tags":["Fiats"],"summary":"Supported fiat currencies and assets","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","name":"Kazakhstani Tenge"},{"code":"VND","name":"Vietnamese Dong"},{"code":"PHP","name":"Philippine Peso"},{"code":"IDR","name":"Indonesian Rupiah"},{"code":"THB","name":"Thai Baht"},{"code":"MXN","name":"Mexican Peso"},{"code":"PEN","name":"Peruvian Sol"},{"code":"CLP","name":"Chilean Peso"},{"code":"BOB","name":"Bolivian Boliviano"},{"code":"GHS","name":"Ghanaian Cedi"},{"code":"KES","name":"Kenyan Shilling"},{"code":"ZAR","name":"South African Rand"},{"code":"AED","name":"UAE Dirham"},{"code":"CNY","name":"Chinese Yuan"},{"code":"BYN","name":"Belarusian Ruble"},{"code":"GEL","name":"Georgian Lari"},{"code":"AZN","name":"Azerbaijani Manat"}],"assets":["USDT","BTC","ETH","BNB","USDC","FDUSD"],"source":"Binance P2P"},"meta":{"timestamp":"2026-06-10T22:56:55.972Z","request_id":"ac97c128-a170-4bfe-bed5-f8a361f85997"},"status":"ok","message":"Fiats retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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:56:56.342Z","request_id":"f1b7d44a-d281-4807-8ba6-dec70c7963c4"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2700,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":75000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2150,"monthly_call_quota":380000,"rps_limit":35,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5100,"monthly_call_quota":2400000,"rps_limit":110,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/p2prates-api"}