FlareForge

API Docs

FlareForge exposes a public HTTP API on every component. All endpoints are GET or POST JSON, no auth required, rate-limited where it matters. Base URL is https://flareforge.io.

Swagger UIReDocOpenAPI JSON

Flare Health

Realtime block time, FTSO participation, FDC proof volume, FAssets throughput. Data is indexed every 10 seconds and persisted in TimescaleDB.

GET/api/v1/network/overview?network=flare

Latest block, gas price, active addresses, FTSO participation, FAssets TVL.

curl https://flareforge.io/api/v1/network/overview?network=flare
GET/api/v1/network/metrics?network=flare&metric=block_time_s&hours=24&bucket=5m

Time-series for a single metric; buckets 1m / 5m / 15m / 1h / 1d.

GET/api/v1/network/ftso/providers?network=flare&limit=50

FTSO provider leaderboard (last 30 days).

GET/api/v1/network/fassets/summary?network=flare

Aggregate FAssets metrics: TVL, active agents, mints/redemptions/liquidations.

Oracle Lab

FTSOv2 block-latency feeds catalog, price history, and strategy backtester. Feeds are sampled every 60 seconds.

GET/api/v1/oracle-lab/feeds

List every active FTSO feed with the latest value and timestamp.

curl https://flareforge.io/api/v1/oracle-lab/feeds | jq
GET/api/v1/oracle-lab/feeds/{feed_id}/history?hours=24&bucket=5m

Time-series history for a single feed. feed_id is the bytes21 hex string.

GET/api/v1/oracle-lab/movers?hours=24&limit=10

Top gainers and losers over a rolling window.

POST/api/v1/oracle-lab/simulate

Run a strategy backtester. Body: { feed_id, sources[{name,jitter_bps,weight}], aggregation, history_hours }.

Agent Monitor

FAssets agents on Flare mainnet. Each agent mints wrapped XRP (FXRP) against vault and pool collateral. Snapshots are captured every 60 seconds.

GET/api/v1/agents

All currently tracked agents with the most recent collateral snapshot.

curl https://flareforge.io/api/v1/agents | jq '.agents[0]'
GET/api/v1/agents/{address}

Detailed state for a single agent vault.

GET/api/v1/agents/{address}/history?hours=24

Metric history (collateral ratio, minted UBA, status) for an agent.

CrossChain Sandbox

Generate mock Flare Data Connector proofs for local tests. Responses are structurally compatible with real FDC; on-chain verification will reject them.

GET/api/v1/sandbox/attestation-types

List supported FDC attestation types and their request / response body schema.

GET/api/v1/sandbox/attestation-types/{type_id}

Get a single attestation type schema.

POST/api/v1/sandbox/generate-proof

Body: { type_id, source_id, fields }. Returns { merkleLeaf, merkleProof[], response }.

Rate limits

Conventions