Вход в кабинет
XRP Ledger · JSON-RPC · rippled

API XRP Ledger
нода Ripple по JSON-RPC

Нода XRP Ledger (rippled) принимает JSON-RPC запросы методом POST с телом {"method":"...","params":[{...}]}. Прокси передаёт запрос ноде и возвращает ответ без изменений. Модель аккаунтов XRPL и destination tag работают точно так же, как при прямом обращении к rippled.

Как подключиться
JSON-RPC
протокол ноды rippled
Все методы
whitelist отсутствует
Старт сегодня
доступ открывается в день обращения
XRP Ledger — подключение
# xrp здесь — имя для примера, реальное название ноды смотрите в кабинете
# account_info — баланс и sequence аккаунта
curl -X POST https://nodes-api.cryptosafe.pro/proxy/xrp \
  -H "Authorization: $CSN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"method":"account_info","params":[{"account":"rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH","ledger_index":"validated"}]}'

# ответ приходит от ноды без изменений
{"result":{"account_data":{"Balance":"49990000000","Sequence":1},"status":"success"}}
Один адрес — методы rippled без изменений
Возможности

Что открывает API XRP Ledger

XRP Ledger устроен иначе, чем UTXO- или EVM-сети: у аккаунтов есть sequence-номер, резерв и общий для многих получателей адрес с destination tag. Наш эндпоинт отдаёт эти данные напрямую с ноды.

Данные аккаунта

account_info возвращает баланс в XRP, sequence для следующей транзакции и флаги аккаунта по состоянию последнего подтверждённого леджера (ledger_index: validated).

Destination tag и история переводов

account_tx показывает историю переводов на адрес вместе с destination tag, который позволяет разделить платежи разных клиентов на одном общем адресе.

Отправка и статус транзакций

submit принимает подписанный tx_blob и передаёт его сети. tx по хэшу транзакции возвращает её текущий статус — оба метода проходят через прокси без изменений.

Ключ с IP-ограничением

Ключ можно привязать к IP-адресам и подсетям CIDR ваших серверов. Запрос с незарегистрированного адреса получит ошибку 8003. Поддерживаются IPv4 и IPv6; до 50 записей на ключ.

Инфраструктура на нас

Синхронизация ноды XRP Ledger, обновления клиента rippled и мониторинг — наша ответственность. Адрес вашего эндпоинта не меняется при любых обновлениях с нашей стороны. Как отслеживать статус переводов — в статье о мониторинге транзакций.

Статистика по запросам

В личном кабинете видно количество запросов к ноде XRP Ledger, долю успешных и время ответа. Метрики собираются с первого дня без дополнительной настройки.

Подключение

Четыре шага до первых запросов к XRP Ledger

От первого сообщения до рабочего API XRP Ledger — обычно в тот же день.

01

Напишите нам

Напишите нам в чат поддержки на сайте: скажите, что нужен доступ к ноде XRP Ledger. Мы откроем кабинет в день обращения.

02

Выпустите ключ

В личном кабинете создайте ключ. При необходимости добавьте IP-адреса серверов, с которых будут идти запросы к ноде XRP Ledger.

03

Укажите адрес эндпоинта

Используйте https://nodes-api.cryptosafe.pro/proxy/xrp как адрес для JSON-RPC запросов к rippled. Добавьте ключ в заголовок Authorization.

04

Отправляйте запросы

Методы account_info, account_tx, submit и tx работают как обычно — прокси прозрачен. В кабинете сразу начнёт накапливаться статистика по вашим вызовам.

Вопросы

Частые вопросы об API XRP Ledger

Как устроен API XRP Ledger?
Нода XRP Ledger (rippled) принимает JSON-RPC запросы методом POST с телом вида {"method":"...","params":[{...}]}. Адрес запроса — https://nodes-api.cryptosafe.pro/proxy/xrp, прокси передаёт тело ноде без изменений и возвращает ответ как есть.
Что такое destination tag и зачем он нужен?
В XRP Ledger один адрес может принадлежать множеству получателей на стороне биржи или обменника, поэтому для идентификации конкретного клиента к переводу добавляется числовой destination tag. Метод account_tx показывает историю переводов на адрес вместе с тегами, указанными отправителями.
Как проверить баланс и данные аккаунта?
Метод account_info возвращает баланс в XRP, порядковый номер (sequence) для следующей транзакции и текущие флаги аккаунта. Запрос идёт с параметром ledger_index: validated — чтобы получить данные по последнему подтверждённому леджеру.
Как отправить подписанную транзакцию?
Метод submit принимает подписанный blob транзакции (tx_blob) и передаёт его сети. Метод tx по хэшу транзакции возвращает её текущий статус — прокси передаёт оба запроса ноде без изменений.
Как правильно передавать ключ аутентификации?
Ключ передаётся в заголовке Authorization без префикса Bearer — именно как значение, без дополнительных слов. Пример: Authorization: ваш-ключ. Ключ выпускается в личном кабинете; на компанию доступно до трёх ключей.
Можно ли ограничить доступ по IP?
Да. Каждый ключ можно привязать к списку IP-адресов и подсетей CIDR — до 50 записей. Поддерживаются IPv4 и IPv6. Пустой список означает доступ с любого адреса. Вспомогательный эндпоинт https://nodes-api.cryptosafe.pro/info/getip вернёт ваш текущий IP текстом.

Нужен API XRP Ledger для вашего сервиса?

Напишите в чат поддержки — откроем доступ к ноде XRP Ledger в день обращения. Ключ выпускаете сами в кабинете, инфраструктуру держим мы.

Вход в кабинет