API Documentation

Base URL: https://api.lucentfi.xyz

All endpoints require an X-API-Key header.

POST/v1/simulate/transfer

Evaluate all available routes for a stablecoin transfer

Request Body:

{
  "from_chain": "ethereum",
  "to_chain": "solana",
  "stablecoin": "USDC",
  "amount": 8000000
}

Returns ranked routes with cost, time, SLS risk score, and split recommendations.

GET/v1/sls/bridge/{bridge_name}

Get the current SLS risk score and factor breakdown for a bridge

Returns composite score, individual factor scores, static bridge data, and 7-day trend.

GET/v1/liquidity/depth

Get current stablecoin supply across all tracked chains

Returns supply and market cap per stablecoin per chain. Supports ?stablecoin= and ?chain= filters.

GET/v1/peg/stability

Monitor stablecoin peg deviations in real time

Returns current price, deviation from peg in bps, 24h change, and stability status.

GET/v1/costs/gas

Compare transfer costs across chains

Returns current gas cost per chain with 7-day average. Supports ?chains= filter.

GET/v1/alerts

Get active alerts for peg deviations, SLS drops, and gas spikes

Returns array of alerts sorted by severity (critical, warning, info).

Quick Start

curl -X POST https://api.lucentfi.xyz/v1/simulate/transfer \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "from_chain": "ethereum",
    "to_chain": "solana",
    "stablecoin": "USDC",
    "amount": 8000000
  }'

Interactive API Docs (Swagger)