API reference
USDF and reserve
The compute dollar, its reserve and hourly holder earnings.
On this page
GET/v1/reserve
The token and reserve, with contract addresses.
Auth: None
No parameters.
GET /v1/reserve
curl https://api.usdf.fi/v1/reserve
GET/v1/reserve/history
The reserve over time.
Auth: None
No parameters.
GET /v1/reserve/history
curl https://api.usdf.fi/v1/reserve/history
GET/v1/reserve/attestations/latest
The most recent reserve attestation.
Auth: None
No parameters.
GET /v1/reserve/attestations/latest
curl https://api.usdf.fi/v1/reserve/attestations/latest
GET/v1/settlements
Settlement batches onchain.
Auth: None
No parameters.
GET /v1/settlements
curl https://api.usdf.fi/v1/settlements
GET/v1/holders/rewards
The terms and the rate: half of network revenue, every hour, sent to each holder's wallet, with this hour's Merkle root.
Auth: None
No parameters.
GET /v1/holders/rewards
curl https://api.usdf.fi/v1/holders/rewards
GET/v1/holders/rewards/{address}
Whether it earns, and what it earned this hour, last hour and in all.
Auth: None
| Name | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Path. A 0x address. |
GET /v1/holders/rewards/{address}
curl https://api.usdf.fi/v1/holders/rewards/{address}GET/v1/holders/rewards/me
The account's own: what its Foundry balance and its linked wallet earned this hour, last hour and in all.
Auth: API key (Authorization: Bearer sk_…) or a session
No parameters.
GET /v1/holders/rewards/me
curl https://api.usdf.fi/v1/holders/rewards/me \ -H "Authorization: Bearer $USDF_API_KEY"