Loam Customer API · Предпросмотр

Центр разработчиков

Начните здесь, чтобы работать с Loam Customer API.

Пять минут Быстрый старт От нового API-клиента до живого ответа: выпустите токен, прочитайте урегулированные остатки, затем запросите валютную котировку. Поток маркетплейса доступен, когда эта функция включена. Следуйте «Быстрому старту» OpenAPI 3.1 Справочник API Изучите опубликованный контракт эндпоинт за эндпоинтом — все области доступа, схемы запросов и ответов и коды ошибок, с конструктором запросов для каждого маршрута. Откройте справочник API

Оба пути требуют учётных данных. Начните с создания API‑клиента.

Платежи, которые вы можете просмотреть сегодня

Получите список платежей организации с помощью токена типа Bearer. Пустая страница — это успех — ничего ещё не зафиксировано. Отправка денег — другой вызов: он требует scope money.write, гранта владельца в рамках повышенной аутентификации и одобренного получателя, и остаётся закрытым в режиме предпросмотра.

GET /api/v1/payments
curl -H "Authorization: Bearer $LOAM_TOKEN" \  "$LOAM_API_BASE/payments"// Response
{
  "ok": true,
  "data": [
    {
      "id": "c4d8e2f0-1a3b-45cd-8e9f-0a1b2c3d4e5f",
      "state": "settled",
      "source_kind": "wallet_transfer",
      "fiat_amount": 2500000,
      "fiat_currency": "USD",
      "crypto_amount": null,
      "crypto_currency": null,
      "trade_id": null,
      "created_at": "2026-07-14T09:12:04.118Z",
      "updated_at": "2026-07-14T09:14:11.004Z",
      "settled_at": "2026-07-14T09:14:11.004Z",
      "failed_at": null
    }
  ],
  "page": { "next_cursor": null }
}

Что покрывает API сегодня

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

Открыть в предварительном просмотре Разрешения read и write

  • Расчётные балансы GET /api/v1/balances
  • Список платежей GET /api/v1/payments
  • Условия казначейского хранилища GET /api/v1/vaults
  • Котировки валютного обмена POST /api/v1/fx/quotes

Закрыто в предварительном просмотре Разрешение money.write

  • Платежи на одобренные назначения POST /api/v1/payments
  • Поступления с банковского счёта POST /api/v1/onramp
  • Вывод средств на банковский счёт POST /api/v1/offramp
  • Внесение и снятие средств из хранилища POST /api/v1/vaults/…

Перемещение средств требует, чтобы владелец организации — человек — предоставил разрешение в рамках повышенной аутентификации, установил лимит на транзакцию и заранее одобрил назначение. Эти конечные точки останутся закрытыми до окончания превью.

Поведение API

  • OAuth 2.0

    Грант «client_credentials»

    Обменяйте client id и secret на краткоживущий bearer‑токен одним запросом с form‑encoded телом. Права (scopes) читаются из клиента для каждого запроса, поэтому их ограничение применяется немедленно.

  • Конверт

    Единый формат для всех маршрутов

    Успех — это ok, затем data; ошибка — это ok: false с машинно‑читаемым кодом ошибки.

  • Идемпотентность

    Повторные попытки ничего не стоят

    Каждая операция записи требует Idempotency-Key. При использовании того же ключа и того же тела повторяется первоначальный результат вместо двойной записи.

  • Пагинация

    Курсоры, не смещения

    Маршруты списка возвращают page.next_cursor. Передавайте его обратно как cursor до тех пор, пока не вернётся null.

Выберите путь: «Быстрый старт», если вы хотите сначала получить рабочий запрос, или справочник, если вы уже знаете нужный вызов.

Следуйте «Быстрому старту» Откройте справочник API