Partner API

Авторизация

Все запросы требуют заголовок X-API-Key, ключ вида rud_pk_ + 32 hex-символа показывается один раз при создании

В командах $RUD_API_KEY обозначает ваш ключ из переменной окружения

curl -s https://rud-stable.ru/api/public/balances \
  -H "X-API-Key: $RUD_API_KEY"

Токены и сети

Расчетный ориентир RUD не является обещанием обмена на наличные USD, фактический курс операции определяется API

Пополнение

1. POST /deposit-intents, body: { "token": "USDT", "amount": "100" }
2. Переведите ровно эту сумму на адрес кассы из ответа
3. POST /deposit-intents/:intentID/check проверяет перевод и зачисляет его, до появления в сети ответ содержит { "found": false }, повторите check позже
4. Открытые заявки: GET /deposit-intents, отмена: DELETE /deposit-intents/:intentID

Пример ответа после обнаружения перевода

{ "found": true, "depositID": 15, "txID": "…", "duplicate": false }

Обмен и вывод

POST /swap принимает { "from": "USDT", "to": "RUD", "amountIn": "50" } и выполняет off-chain обмен только при наличии ликвидности

Пример запроса на вывод

POST /withdraw
{ "token": "USDT", "chain": "tron", "address": "T…", "amount": "25", "requestId": "withdrawal-001" }

Пример подтвержденного ответа

{ "withdrawalId": 7, "status": "confirmed", "rudBurned": "25" }

Для вывода сеть обязана соответствовать токену, requestId задает идемпотентность, при неоднозначном on-chain результате не повторяйте отправку автоматически

Балансы, курсы и история

curl -s "https://rud-stable.ru/api/public/rates?token=RUBA" \
  -H "X-API-Key: $RUD_API_KEY"

Доступные запросы чтения

GET /balances
GET /rates?token=RUBA
GET /deposit-address?chain=eth|tron|kaia
GET /history

Курс возвращает строковый точный decimal rate и source, денежные значения не следует преобразовывать через binary floating point

Ошибки

Формат ошибки

{ "error": "invalid api key" }