Введение
API p3p — это публичный HTTP/JSON интерфейс к кросс-чейн обмену p3p. Он позволяет:
- Получать поддерживаемые сети, токены и актуальные рыночные курсы
- Получать котировки и выполнять свопы через несколько агрегированных источников ликвидности
- Принимать платежи как мерчант через инвойсы, со средствами, поступающими напрямую на ваш кошелёк
p3p является некастодиальным: API никогда не удерживает средства пользователя дольше нескольких секунд, необходимых для маршрутизации свопа, и вам никогда не нужно делиться приватными ключами или проходить KYC.
Базовый URL
https://api.p3p.xyzМодель аутентификации
p3p имеет два различных типа пользователей с разными требованиями к аутентификации.
Разработчики
Разработчики, создающие приложения, которые программно выполняют свопы (получение сетей, токенов, курсов, создание обменов), должны включать действительный заголовок api-key в каждый запрос.
api-key: your_api_key_here| Сценарий использования | Что вам нужно |
|---|---|
| Получить сети, токены, курсы | Заголовок api-key |
| Получить котировку свопа | Заголовок api-key |
| Выполнить своп | Заголовок api-key |
| Получать долю дохода со свопов | Заголовок api-key + opts.partner_id с вашим кошельком |
Чтобы получить ключ API, свяжитесь с нами в Telegram.
Мерчанты
Мерчанты принимают крипто платежи через инвойсы. Ключ API не требуется — адрес вашего кошелька — это ваша идентификация.
| Сценарий использования | Что вам нужно |
|---|---|
| Создать инвойс | Адрес вашего кошелька как wallet_merchant в теле запроса |
| Просмотр ваших инвойсов / доходов | Адрес вашего кошелька в URL партнёрских эндпоинтов |
Без регистрации. Без токенов. Просто используйте свой кошелёк. См. руководство Мерчанты.
Формат ответа
Каждый эндпоинт возвращает JSON.
Успех:
{ "id": "ex_...", "status": "waiting", "...": "..." }Ошибка:
{ "error": "wallet_to_invalid", "message": "wallet_to has invalid address: ..." }Ограничения частоты
Если вы получаете HTTP 429, замедлитесь или свяжитесь с нами, чтобы поднять лимит для вашего проекта.