Finance OS / API

Finance OS API

Programmable finance for crypto, fiat и кросс-граничные платежи. Подключайте кошельки, торгуйте через API, управляйте майнингом и проводите OTC-сделки в нескольких строках кода.

01
Authentication
Получите секретный API-ключ и сделайте первый запрос за 60 секунд.
02
Make a call
Merchant API: клиенты, кошельки, платежи. cURL, JS, PHP или Python.
03
Handle responses
Формат ответа, коды ошибок, пагинация и rate limiting.

Обзор

Finance OS API построен поверх REST-семантики, использует JSON для тел запросов и ответов и аутентификацию секретным API-ключом в заголовке Authorization: Bearer. Все запросы должны выполняться по HTTPS - обычный HTTP отклоняется.

ℹ
Базовый URL
Все эндпоинты живут на https://fin-os.io/api/v1. Окружение выбирается префиксом ключа: sk_live_… - бой, sk_test_… - песочница.

Модули

Полностью описаны в v1:

  • Merchant API - клиенты, их крипто-кошельки, платежи, мастер-счёт, вебхуки и песочница
  • AML Screening API - скоринг блокчейн-адресов, отчёты и выгрузка PDF
  • Payment Gateway (RUB) - приём рублёвых платежей, возвраты, фискальные чеки

В работе (помечены coming soon в навигации):

  • Trading API — AI-стратегии, копи-трейдинг, портфели
  • Mining Pools — Stratum-настройки, статистика воркеров
  • OTC & P2P — внебиржевые сделки, эскроу
  • Business Suite — счета, ВЭД, бухгалтерия, накладные
  • Cross-Border Payments, Tax Reports, Messenger, Loyalty, Algo Bridge

Conventions

Несколько правил, которые держатся во всей документации:

  • Все запросы и ответы — JSON, заголовок Content-Type: application/json
  • Поля с датой/временем — ISO-8601 в UTC (2026-05-27T14:23:00Z)
  • Суммы — строки с десятичной точкой (например "1234.56789"), чтобы избежать float-погрешностей
  • Идентификаторы ресурсов — UUID v4, не auto-increment
  • Версия зафиксирована в пути: /api/v1/…; ломающие изменения выйдут новым major-префиксом

Примеры кода

curl -X GET https://fin-os.io/api/v1/merchant/balance \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Accept: application/json"
const res = await fetch("https://fin-os.io/api/v1/merchant/balance", {
  headers: {
    "Authorization": `Bearer ${TOKEN}`,
    "Accept": "application/json",
  },
});
const balance = await res.json();
console.log(balance);
$response = Http::withToken($token)
    ->acceptJson()
    ->get('https://fin-os.io/api/v1/merchant/balance');

$balance = $response->json();
import requests

r = requests.get(
    "https://fin-os.io/api/v1/merchant/balance",
    headers={
        "Authorization": f"Bearer {TOKEN}",
        "Accept": "application/json",
    },
)
balance = r.json()