Основное

• URL: https://p2p.army/v1/api
• Запросы в формате: JSON
• Ответы в формате: JSON
• Авторизация через HTTP-заголовок:
  X-APIKEY: YOUR_API_KEY
• В случае ошибки добавляется в ответе параметр errText.

Цены и условия

Условия использования и стоимость API доступно на странице https://p2p.army/ru/api_p2p

Пример запроса

curl -H "X-APIKEY: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
    -X POST 'https://p2p.army/v1/api/get_p2p_assets' \
    -d '{"market":"bybit","fiat":"RUB"}'

Где, XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - ваш ключ.

Проверка доступности API

curl 'https://p2p.army/v1/api/ping'

Время сервера

curl 'https://p2p.army/v1/api/time'

P2P платформы

Получение списка поддерживаемых P2P платформ.

{
    "rows": [
        "binance",
        "bybit",
        "huobi",
        "okx",
        "bitget",
        "bingx",
        "kucoin",
        "mexc"
    ],
    "status": 1
}

curl 'https://p2p.army/v1/api/get_p2p_markets'

Фиатные валюты

Получение списка фиатных валют в P2P.

{
    "rows": [
        "AED",
        "ALL",
        "AMD",
        "AOA",
        "ARS",
        "AUD",
        "AZN",
        "BAM",
        ...,
        "XOF",
        "YER",
        "ZAR",
        "ZMW"
    ],
    "status": 1
}

curl -X POST 'https://p2p.army/v1/api/get_p2p_fiats'

Криптоактивы P2P

Получение криптоактивов в P2P.

curl -X POST 'https://p2p.army/v1/api/get_p2p_assets' -d '{"market":"bybit","fiat":"RUB"}'

{
    "assets": [
        "USDT",
        "BTC",
        "ETH",
        "USDC"
    ],
    "status": 1
}

Платежные методы P2P

Получение платежных методов в P2P по вводным данным: market+fiat.

curl -X POST 'https://p2p.army/v1/api/get_popular_p2p_payment_methods' -d '{"market":"bybit","fiat":"RUB"}'

{
    "payment_methods": [
        {
            "ads_count_BUY": 193,
            "ads_count_SELL": 202,
            "ads_count_total": 395,
            "activity_24h": 20414,
            "market": "bybit",
            "title": "Raiffeisenbank",
            "payment_method": "Raiffeisenbank",
            "payment_method_vendor_id": 64
        },
        {
            "ads_count_BUY": 124,
            "ads_count_SELL": 173,
            "ads_count_total": 297,
            "activity_24h": 25717,
            "market": "bybit",
            "title": "Local Card(Green)",
            "payment_method": "Local Card(Green)",
            "payment_method_vendor_id": 582
        },
        ...
       ],
    "status": 1
}

Цены P2P

Получение цен на P2P платформе по вводным данным: market+fiat+asset.

curl -X POST 'https://p2p.army/v1/api/get_p2p_prices' -d '{"market":"bybit","fiat":"RUB","asset":"USDT","limit":10}'

{
    "status": 1,
    "prices": [
        {
            "payment_method": "Local Card(Yellow)",
            "payment_method_vendor_id": 582,
            "updated_BUY": 1712707049,
            "updated_SELL": 1712707049,
            "prices_BUY": [
                "94.79",
                "95.29",
                "95.5",
                "95.8",
                "95.87",
                "95.99",
                "96",
                "96",
                "96",
                "96.1"
            ],
            "prices_SELL": [
                "102.1",
                "96.5",
                "94.41",
                "94.38",
                "94.3",
                "94.25",
                "94.24",
                "94.21",
                "94.14",
                "94.03"
            ],
            "avg_price_BUY": 95.734,
            "avg_price_SELL": 95.256,
            "activity_24h": 19660,
            "ads_count_BUY": 69,
            "ads_count_SELL": 79,
            "ads_count_total": 148
        },
        ...
    ]
}

***Например: когда в массиве цены 110, 92.33, 92.28, 92.25, 92.22, 92.19, то перед вычислением средней цены 110 будет удалено, т.к. это число отличается больше чем на 10% от остальных.

Объявления P2P

Получение объявлений на P2P платформе по вводным данным: market+fiat+asset+side.

Метод возвращает объявления в едином формате со всех бирж.

curl -X POST 'https://p2p.army/v1/api/get_p2p_order_book' -d '{"market":"bybit","fiat":"RUB","asset":"USDT","side":"BUY","payment_method":"Raiffeisenbank","limit":10}'

{
    "status": 1,
    "ads": [
        {
            "pos": 1,
            "updated_at": 1712710660,
            "market": "bybit",
            "asset": "USDT",
            "fiat": "RUB",
            "side": "BUY",
            "payment_methods": [
                "Raiffeisenbank"
            ],
            "price": "96",
            "surplus_amount": "62.5708",
            "surplus_fiat": 6006.7968,
            "min_fiat": "500",
            "max_fiat": "6006.79",
            "text": "от 3 лиц принимаю, условия : чек и в комментарии указать «возврат долга»",
            "user_name": "Mahdi95",
            "user_id": "131584562",
            "adv_id": "1777707816377614336",
            "user_orders": 415,
            "user_rate": 100,
            "is_merchant": 0
        },
        ...
         ]
}

Vendor Ads

Получение оригинальных объявлений с P2P платформ по вводным данным: market+fiat+asset+side.

Каждая платформа отдает объявления в разных форматах.

curl -X POST 'https://p2p.army/v1/api/get_p2p_vendor_book' -d '{"market":"bybit","fiat":"RUB","asset":"USDT","side":"BUY","limit":10}'

{
    "status": 1,
    "vendor_ads": [
        {
            ...
        },
        {
            ...
        },
        {
            ...
        },
        ...
     ]
}

vendor_ads содержит информацию от бирж без фильтраций с нашей стороны. У каждой биржи свой формат ответа.

Статистика P2P бирж

Получение статистики P2P бирж, которая доступна на странице https://p2p.army/ru/p2p/markets.

curl -X POST 'https://p2p.army/v1/api/stat/p2p_markets' -d '{"limit":10}'

{
    "status": 1,
    "markets": [
        {
            "id": 1,
            "name": "binance",
            "title": "Binance P2P",
            "place": 1,
            "activity_24h": 1624870,
            "ads_BUY": 9755,
            "ads_SELL": 24723,
            "ads_total": 34478,
            "volume_usd_BUY": "41644784.7424",
            "volume_usd_SELL": "139034136.9520",
            "volume_usd_total": "180678921.6944",
            "count_fiats": 119
        },
        ...
    ]
}

Статистика P2P валют

Получение статистики P2P валют, которая доступна на странице https://p2p.army/ru/p2p/fiats.

curl -X POST 'https://p2p.army/v1/api/stat/p2p_fiats' -d '{"type":"ads_count"}'

{
    "status": 1,
    "fiats": [
        {
            "fiat": "USD",
            "points": 6431,
            "by_markets": {
                "binance": "3773",
                "okx": "343",
                "bybit": "701",
                "huobi": "1232",
                "bitget": "207",
                "kucoin": "175",
                "mexc": 0
            }
        },
        ...
    ]
}

История P2P цен

Получение истории P2P цен, которая доступна на странице https://p2p.army/ru/p2p/fiats/CNY/charts/USDT.

curl -X POST 'https://p2p.army/v1/api/history/p2p_prices' -d '{"market":"binance","fiat":"CNY","asset":"USDT","payment_method":"Alipay","mode":"ALL","limit":10}'

curl -X POST 'https://p2p.army/v1/api/history/p2p_prices' -d '{"market":"bybit","fiat":"RUB","asset":"USDT","payment_method":"Raiffeisenbank","mode":"ALL","limit":10}'

{
    "history": [
        {
            "date": "2024-04-10T03:00:00.000000Z",
            "buy": 95.8,
            "buy_avg": 95.98,
            "sell": 95.31,
            "sell_avg": 95.238
        },
        {
            "date": "2024-04-10T02:00:00.000000Z",
            "buy": 96,
            "buy_avg": 96.066,
            "sell": 102.1,
            "sell_avg": 96.846
        },
        {
            "date": "2024-04-10T01:00:00.000000Z",
            "buy": 96,
            "buy_avg": 96.088,
            "sell": 102.1,
            "sell_avg": 96.832
        },
        ...
    ]
}