3. API для бирж

Базовый URL

Все запросы — GET, ответ — JSON. Отвечает любым origin (CORS Access-Control-Allow-Origin: *). Ошибки: 404 с {"error":"..."}.

https://185.253.219.51:8084/api/...

Проверка транзакции

Наличие транзакции, блок и число подтверждений:

GET /api/tx/{txid}
{
  "txid":"...",
  "blockhash":"...",
  "blockheight":12461,
  "confirmations":1,
  "time":1768000000,
  "blocktime":1768000000,
  "vin":[...],
  "vout":[{"value":50.0,"scriptPubKey":{"addresses":["L..."]}}]
}

Правило для биржи: принимать перевод после N подтверждений (поле confirmations, обычно N = 6+). Если транзакция не найдена — ответ 404, значит она ещё не в блокчейне.

Баланс адреса

GET /api/balance/{address}
{
  "address":"L...",
  "balance":1.5,
  "balance_base_units":150000000,
  "received":2.0,
  "received_base_units":200000000
}

balance_base_units — баланс в самых мелких единицах (сатоши). balance — то же в LBTC. Только подтверждённые выходы.

Адрес + история

GET /api/address/{address}
{
  "address":{"address":"L...","isvalid":true},
  "txs":[{...}, {...}]
}

Валидация адреса и список транзакций адреса (из адрес-индекса ноды), каждая — с vin/vout и confirmations.

Блоки и статус

EndpointЧто возвращает
/api/block/{height|hash}Блок: height, hash, time, tx, size, confirmations
/api/blocksПоследние блоки (height, hash, txs, size)
/api/stats Сложность, hashrate, последние блоки
/api/statusСтатус ноды: блок, txs-в-мемпуле, транзакции и т.д.