P2P.Army API

Детальное руководство по API сервиса P2P.Army. Позволяет получать актуальные данные о P2P-рынках, ценах, объявлениях, а также историческую статистику. Для доступа ко всем методам (кроме ping и time) требуется API-ключ, передаваемый в заголовке X-APIKEY.

Базовый URL

https://p2p.army/v1/api
Основной API сервер

Авторизация

ApiKeyAuth (apiKey)

Ваш персональный API ключ.

header: X-APIKEY

Быстрый старт

Для использования приватных методов API необходимо получить API ключ в личном кабинете и передавать его в заголовке X-APIKEY для каждого запроса.

Общее

GET/ping

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

Ответы

200API доступно
Пример JSON:
{
  "pong": 1
}
import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://p2p.army/v1/api/ping',
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
GET/time

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

Возвращает текущее время сервера в формате Timestamp UTC.

Ответы

200Успешный ответ
Пример JSON:
{
  "time": 1712710660
}
import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://p2p.army/v1/api/time',
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js

P2P Данные

POST/get_p2p_markets

Список P2P платформ

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

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
rows
array<string>
status
StatusСтатус ответа (1 - успешно)
Пример JSON:
{
  "rows": [
    "binance",
    "bybit",
    "huobi",
    "okx",
    "bitget",
    "bingx",
    "kucoin",
    "mexc"
  ],
  "status": 1
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/get_p2p_markets',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
POST/get_p2p_fiats

Список фиатных валют

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

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
rows
array<string>
status
StatusСтатус ответа (1 - успешно)
Пример JSON:
{
  "rows": [
    "AED",
    "ALL",
    "AMD",
    "RUB",
    "USD",
    "EUR"
  ],
  "status": 1
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/get_p2p_fiats',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
POST/get_p2p_assets

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

Получение доступных криптоактивов для конкретной биржи и валюты.

Тело запроса

application/json
СвойствоТипОписание
market*
stringКод биржи (например, binance)
fiat*
stringКод фиатной валюты (например, RUB)

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
assets
array<string>
status
StatusСтатус ответа (1 - успешно)
Пример JSON:
{
  "assets": [
    "USDT",
    "BTC",
    "ETH",
    "USDC"
  ],
  "status": 1
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/get_p2p_assets',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "market": "string",
      "fiat": "string"
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
POST/get_popular_p2p_payment_methods

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

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

Тело запроса

application/json
СвойствоТипОписание
market*
string
fiat*
string
limit
integerЛимит вывода

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
payment_methods
array<PaymentMethod>
ads_count_BUY
integerКол-во объявлений в BUY разделе
ads_count_SELL
integerКол-во объявлений в SELL разделе
ads_count_total
integerВсего объявлений
activity_24h
integerАктивность за 24 часа
market
stringКод биржи
title
stringНазвание платежного метода
payment_method
stringКод платежного метода
payment_method_vendor_id
integerID платежного метода на платформе (только у некоторых)
status
StatusСтатус ответа (1 - успешно)
Пример JSON:
{
  "payment_methods": [
    {
      "ads_count_BUY": 0,
      "ads_count_SELL": 0,
      "ads_count_total": 0,
      "activity_24h": 0,
      "market": "string",
      "title": "string",
      "payment_method": "string",
      "payment_method_vendor_id": 0
    }
  ],
  "status": 0
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/get_popular_p2p_payment_methods',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "market": "string",
      "fiat": "string",
      "limit": 0
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
POST/get_p2p_prices

Цены P2P

Получение агрегированных цен на P2P платформе.

Тело запроса

application/json
СвойствоТипОписание
market*
string
fiat*
string
asset*
string
limit
integerЛимит ТОП цен (по умолчанию 10)

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
prices
array<P2PPrice>
payment_method
stringКод платежного метода
payment_method_vendor_id
integer
updated_BUY
integerTimestamp UTC синхронизации цен BUY
updated_SELL
integerTimestamp UTC синхронизации цен SELL
prices_BUY
array<string>Массив ТОП10 цен из BUY раздела
prices_SELL
array<string>Массив ТОП10 цен из SELL раздела
avg_price_BUY
numberСредняя цена из BUY (с фильтрацией выбросов)
avg_price_SELL
numberСредняя цена из SELL (с фильтрацией выбросов)
activity_24h
integerАктивность за 24 часа
ads_count_BUY
integer
ads_count_SELL
integer
ads_count_total
integer
status
StatusСтатус ответа (1 - успешно)
Пример JSON:
{
  "prices": [
    {
      "payment_method": "string",
      "payment_method_vendor_id": 0,
      "updated_BUY": 0,
      "updated_SELL": 0,
      "prices_BUY": [
        "string"
      ],
      "prices_SELL": [
        "string"
      ],
      "avg_price_BUY": 0,
      "avg_price_SELL": 0,
      "activity_24h": 0,
      "ads_count_BUY": 0,
      "ads_count_SELL": 0,
      "ads_count_total": 0
    }
  ],
  "status": 0
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/get_p2p_prices',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "market": "string",
      "fiat": "string",
      "asset": "string",
      "limit": 0
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
POST/get_p2p_order_book

Объявления P2P (Стандарт)

Получение объявлений в едином формате со всех поддерживаемых бирж.

Тело запроса

application/json
СвойствоТипОписание
market*
string
fiat*
string
asset*
string
side*
string
payment_method
stringКод платежного метода
limit
integer
amount
numberФильтр по фиатной сумме

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
ads
array<P2PAd>
pos
integerПозиция объявления
updated_at
integerTimestamp UTC, время получения объявления
market
stringКод биржи
asset
stringКриптоактив
fiat
stringФиатная валюта
side
string
payment_methods
array<string>Список всех указанных платежных методов
price
stringЦена
surplus_amount
stringОбъем криптоактива в объявлении
surplus_fiat
numberОбъем объявления в фиате (surplus_amount * price)
min_fiat
stringМинимальная сумма сделки
max_fiat
stringМаксимальная сумма сделки
text
stringТекст объявления (если доступно)
user_name
stringИмя пользователя на P2P бирже
user_id
stringID пользователя на P2P бирже (формат зависит от платформы)
adv_id
stringID объявления на P2P бирже
user_orders
integerКол-во ордеров (всего или за 30 дней)
user_rate
integerПроцент выполнения ордеров
is_merchant
integerСтатус мерчанта
status
StatusСтатус ответа (1 - успешно)
Пример JSON:
{
  "ads": [
    {
      "pos": 0,
      "updated_at": 0,
      "market": "string",
      "asset": "string",
      "fiat": "string",
      "side": "string",
      "payment_methods": [
        "string"
      ],
      "price": "string",
      "surplus_amount": "string",
      "surplus_fiat": 0,
      "min_fiat": "string",
      "max_fiat": "string",
      "text": "string",
      "user_name": "string",
      "user_id": "string",
      "adv_id": "string",
      "user_orders": 0,
      "user_rate": 0,
      "is_merchant": 0
    }
  ],
  "status": 0
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/get_p2p_order_book',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "market": "string",
      "fiat": "string",
      "asset": "string",
      "side": "string",
      "payment_method": "string",
      "limit": 0,
      "amount": 0
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
POST/get_p2p_vendor_book

Vendor Ads (Оригинал)

Получение оригинальных объявлений с P2P платформ без приведения к единому формату.

Тело запроса

application/json
СвойствоТипОписание
market*
string
fiat*
string
asset*
string
side*
string
limit
integer

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
vendor_ads
array<object>Массив данных от бирж в их оригинальном формате
status
StatusСтатус ответа (1 - успешно)
Пример JSON:
{
  "vendor_ads": [
    {}
  ],
  "status": 0
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/get_p2p_vendor_book',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "market": "string",
      "fiat": "string",
      "asset": "string",
      "side": "string",
      "limit": 0
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js

Статистика

POST/stat/p2p_markets

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

Получение глобальной статистики по P2P платформам.

Тело запроса

application/json
СвойствоТипОписание
limit
integer

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
markets
array<MarketStat>
id
integerВнутренний ID биржи
name
stringКод биржи
title
stringНазвание биржи
place
integerМесто в рейтинге
activity_24h
integerИндекс активности от P2P.Army
ads_BUY
integerКол-во объявлений в BUY секции
ads_SELL
integerКол-во объявлений в SELL секции
ads_total
integer
volume_usd_BUY
stringОбъем в $ объявлений в BUY секции
volume_usd_SELL
stringОбъем в $ объявлений в SELL секции
volume_usd_total
string
count_fiats
integerКол-во представленных фиатных валют
status
StatusСтатус ответа (1 - успешно)
Пример JSON:
{
  "markets": [
    {
      "id": 0,
      "name": "string",
      "title": "string",
      "place": 0,
      "activity_24h": 0,
      "ads_BUY": 0,
      "ads_SELL": 0,
      "ads_total": 0,
      "volume_usd_BUY": "string",
      "volume_usd_SELL": "string",
      "volume_usd_total": "string",
      "count_fiats": 0
    }
  ],
  "status": 0
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/stat/p2p_markets',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "limit": 0
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
POST/stat/p2p_fiats

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

Получение статистики распределения объявлений и объемов по валютам.

Тело запроса

application/json
СвойствоТипОписание
type*
stringТип запрашиваемой статистики
limit
integer

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
fiats
array<object>
fiat
string
points
numberСуммарное значение по всем биржам
by_markets
objectЗначения в разрезе бирж
status
StatusСтатус ответа (1 - успешно)
Пример JSON:
{
  "fiats": [
    {
      "fiat": "string",
      "points": 0,
      "by_markets": {}
    }
  ],
  "status": 0
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/stat/p2p_fiats',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "type": "string",
      "limit": 0
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js

История

POST/history/p2p_prices

История цен

Получение исторических данных о ценах с детализацией по часам или дням.

Тело запроса

application/json
СвойствоТипОписание
market*
string
fiat*
string
asset*
string
payment_method*
stringКод платежного метода
mode
stringПредустановленный период
from_date
stringНачало периода (Timestamp UTC), если не указан mode
to_date
stringКонец периода (Timestamp UTC), если не указан mode
period_type
stringДетализация: 1H (по часам) или 0-23 (конкретный час суток)
date_format
string
limit
integer

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
history
array<object>
date
string
buy
numberМинимальная цена BUY
buy_avg
numberСредняя цена BUY ТОП5
sell
numberМаксимальная цена SELL
sell_avg
numberСредняя цена SELL ТОП5
Пример JSON:
{
  "history": [
    {
      "date": "string",
      "buy": 0,
      "buy_avg": 0,
      "sell": 0,
      "sell_avg": 0
    }
  ]
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/history/p2p_prices',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "market": "string",
      "fiat": "string",
      "asset": "string",
      "payment_method": "string",
      "mode": "string",
      "from_date": "string",
      "to_date": "string",
      "period_type": "string",
      "date_format": "string",
      "limit": 0
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
POST/history/p2p_markets

История бирж

Исторические показатели активности и объемов конкретной биржи.

Тело запроса

application/json
СвойствоТипОписание
market*
string
from_date*
stringНачало периода (Timestamp или YYYY-MM-DD)
to_date
string
date_format
string
limit
integer

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
rows
array<object>
date
string
activity24H
integer
count_BUY
integer
count_SELL
integer
volume_usd_BUY
string
volume_usd_SELL
string
count
integer
first_row_date
string
last_row_date
string
Пример JSON:
{
  "rows": [
    {
      "date": "string",
      "activity24H": 0,
      "count_BUY": 0,
      "count_SELL": 0,
      "volume_usd_BUY": "string",
      "volume_usd_SELL": "string"
    }
  ],
  "count": 0,
  "first_row_date": "string",
  "last_row_date": "string"
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/history/p2p_markets',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "market": "string",
      "from_date": "string",
      "to_date": "string",
      "date_format": "string",
      "limit": 0
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js
POST/history/p2p_fiats

История фиатов

Исторические показатели активности и объемов по конкретной валюте на выбранной бирже.

Тело запроса

application/json
СвойствоТипОписание
market*
string
fiat*
string
from_date*
string
to_date
string
date_format
string
limit
integer

Ответы

200Успешный ответ
Структура ответа:
СвойствоТипОписание
rows
array<object>
date
string
activity24H
integer
count_BUY
integer
count_SELL
integer
volume_usd_BUY
string
volume_usd_SELL
string
count
integer
first_row_date
string
last_row_date
string
Пример JSON:
{
  "rows": [
    {
      "date": "string",
      "activity24H": 0,
      "count_BUY": 0,
      "count_SELL": 0,
      "volume_usd_BUY": "string",
      "volume_usd_SELL": "string"
    }
  ],
  "count": 0,
  "first_row_date": "string",
  "last_row_date": "string"
}
import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://p2p.army/v1/api/history/p2p_fiats',
  headers: {
    'X-APIKEY': 'YOUR_API_KEY'
  },
  data: {
      "market": "string",
      "fiat": "string",
      "from_date": "string",
      "to_date": "string",
      "date_format": "string",
      "limit": 0
  }
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
js

Схемы данных

Status

СвойствоТипОписание
Статус ответа (1 - успешно)

ErrorResponse

СвойствоТипОписание
statusinteger
errTextstringОписание ошибки

P2PAd

СвойствоТипОписание
posintegerПозиция объявления
updated_atintegerTimestamp UTC, время получения объявления
marketstringКод биржи
assetstringКриптоактив
fiatstringФиатная валюта
sidestring
BUYSELL
payment_methodsarray <string>Список всех указанных платежных методов
pricestringЦена
surplus_amountstringОбъем криптоактива в объявлении
surplus_fiatnumberОбъем объявления в фиате (surplus_amount * price)
min_fiatstringМинимальная сумма сделки
max_fiatstringМаксимальная сумма сделки
textstringТекст объявления (если доступно)
user_namestringИмя пользователя на P2P бирже
user_idstringID пользователя на P2P бирже (формат зависит от платформы)
adv_idstringID объявления на P2P бирже
user_ordersintegerКол-во ордеров (всего или за 30 дней)
user_rateintegerПроцент выполнения ордеров
is_merchantintegerСтатус мерчанта
01

PaymentMethod

СвойствоТипОписание
ads_count_BUYintegerКол-во объявлений в BUY разделе
ads_count_SELLintegerКол-во объявлений в SELL разделе
ads_count_totalintegerВсего объявлений
activity_24hintegerАктивность за 24 часа
marketstringКод биржи
titlestringНазвание платежного метода
payment_methodstringКод платежного метода
payment_method_vendor_idintegerID платежного метода на платформе (только у некоторых)

P2PPrice

СвойствоТипОписание
payment_methodstringКод платежного метода
payment_method_vendor_idinteger
updated_BUYintegerTimestamp UTC синхронизации цен BUY
updated_SELLintegerTimestamp UTC синхронизации цен SELL
prices_BUYarray <string>Массив ТОП10 цен из BUY раздела
prices_SELLarray <string>Массив ТОП10 цен из SELL раздела
avg_price_BUYnumberСредняя цена из BUY (с фильтрацией выбросов)
avg_price_SELLnumberСредняя цена из SELL (с фильтрацией выбросов)
activity_24hintegerАктивность за 24 часа
ads_count_BUYinteger
ads_count_SELLinteger
ads_count_totalinteger

MarketStat

СвойствоТипОписание
idintegerВнутренний ID биржи
namestringКод биржи
titlestringНазвание биржи
placeintegerМесто в рейтинге
activity_24hintegerИндекс активности от P2P.Army
ads_BUYintegerКол-во объявлений в BUY секции
ads_SELLintegerКол-во объявлений в SELL секции
ads_totalinteger
volume_usd_BUYstringОбъем в $ объявлений в BUY секции
volume_usd_SELLstringОбъем в $ объявлений в SELL секции
volume_usd_totalstring
count_fiatsintegerКол-во представленных фиатных валют