API Reference

LitVM·Scan public APIs

Three lightweight JSON endpoints that augment the upstream Blockscout REST API. No auth required, no analytics, no tracking. All responses are JSON.

For the full historical / index API, use the upstream Blockscout v2 endpoints athttps://liteforge.explorer.caldera.xyz/api/v2/*.

GET/api/health

Live network health: RPC chain head vs Blockscout indexer head, lag, latency.

cache: no-store · always fresh

Example

curl https://your-deploy/api/health

Response

{
  "status": "ok" | "degraded" | "down",
  "rpc_head": 11500000,
  "indexer_head": 11499900,
  "lag": 100,
  "latency_ms": 250,
  "avg_block_time": 150,
  "ts": "2026-05-23T08:50:00.000Z"
}

GET/api/price

Live LTC / USD price from CoinGecko, including 24h change. zkLTC ≡ 1 LTC.

cache: 60 seconds server-side

Example

curl https://your-deploy/api/price

Response

{
  "ltc_usd": 51.99,
  "ltc_usd_24h_change": -4.33,
  "ts": "2026-05-23T08:50:00.000Z",
  "source": "coingecko"
}

GET/api/decode/[sig]

Resolve a 4-byte function or event selector to a human-readable signature. Falls back from openchain.xyz to 4byte.directory.

cache: 24 hours per selectorrate-limit: 60 req / minute / IP

Example

curl https://your-deploy/api/decode/0xa9059cbb

Response

{
  "name": "transfer",
  "full": "transfer(address,uint256)",
  "source": "openchain"
}

Error codes

Status	Meaning
200	OK · JSON body returned
400	Invalid input (e.g. malformed 4-byte selector)
429	Rate-limited · Retry-After header indicates seconds to wait
5xx	Upstream dependency failure · response includes `error` field