fillr

REST endpoints exposed by the @usefillr/api service. Use these to query commitment history without hitting Solana RPC.

The indexer is a separate service from the app. The hosted endpoint URL will be published here once mainnet ships. For now, run it locally from api/ in the fillr repo.

GET /v1/commitments

Filtered list of commitments. Most-recent first.

bash
curl 'https://api.usefillr.app/v1/commitments?owner=<base58>&status=active&limit=50'

Query params:

owner — base58 pubkey filter
mint — target mint filter
status — active | executed | cancelled | expired
limit — max 500, default 100

GET /v1/commitments/:address

Look up one commitment by its PDA address.

bash
curl 'https://api.usefillr.app/v1/commitments/6EoiaS1kuow1u7iZJJqFwUMDnz2oSRE6fASyzruVMp7g'

GET /v1/stats

Live counts of active + last-24h status changes.

json
{
  "activeCount": 17,
  "filledCount24h": 4,
  "cancelledCount24h": 1,
  "expiredCount24h": 0
}

WebSocket (planned)

Real-time push for commit:new, commit:status, and mint:routable channels. Subscribe by sending an {"op":"subscribe","channel":"..."} message. Lights up after Helius LaserStream integration lands.