A read-only JSON API over indexed FWA data. Every endpoint is a GET and returns a consistent response envelope so metadata and provenance travel with every payload.
/api/overviewPool-wide snapshot: backing, weight, acquisition price, activity.
/api/poolDetailed pool state and distribution statistics.
/api/positionsPaginated list of positions with backing, weight and status.
/api/positions/[listingId]A single position with its derived metrics.
/api/collectionsCollections with positions in the pool.
/api/collections/[address]One collection's positions and aggregates.
/api/wallets/[address]A wallet's positions, fees, rewards and exposure.
/api/activityChronological protocol activity feed.
/api/crownCurrent Top Depositor, pot and takeover threshold.
/api/acquisitionsAcquisition history and price changes.
/api/rewardsReward emissions and distribution data.
/api/simulatorEstimated position metrics for hypothetical backing.
Bracketed segments such as [listingId] and [address] are path parameters.
Shared query parameters. Not every parameter applies to every endpoint; unsupported ones are ignored.
| Parameter | Type | Description |
|---|---|---|
page | number | 1-based page index for paginated collections (default 1). |
pageSize | number | Items per page (bounded server-side). |
sort | string | Field to sort by, e.g. backing, weight, timestamp. |
order | asc | desc | Sort direction (default desc). |
filters | string | Endpoint-specific filters, e.g. status, collection, type. |
blockNumber | number | Read state as of a specific block (historical snapshot). |
dateFrom | ISO date | Lower time bound for time-series or activity queries. |
dateTo | ISO date | Upper time bound for time-series or activity queries. |
Every response wraps its payload in data alongside a metadata object; list endpoints add pagination.
metadata.sourceBlockBlock the data was read at.
metadata.indexedAtISO timestamp of indexing.
metadata.isEstimatedTrue when the payload contains estimates.
metadata.demoTrue while serving placeholder demo data.
metadata.noteOptional human-readable context.
paginationpage, pageSize, total, hasMore (lists only).
GET /api/positions?page=1&pageSize=2&sort=backing&order=desc
{
"data": [
{
"listingId": "1042",
"collectionName": "Fake Apes",
"tokenId": "318",
"backingWei": "3200000000000000000",
"weight": "312500000000000000",
"status": "ACTIVE",
"isCrown": false
}
],
"metadata": {
"sourceBlock": 21000000,
"indexedAt": "2026-07-26T12:00:00.000Z",
"isEstimated": false,
"demo": true,
"note": "Demo data — verified ABIs and an RPC are not yet configured."
},
"pagination": {
"page": 1,
"pageSize": 2,
"total": 128,
"hasMore": true
}
}The public endpoints are read-only. Authenticated API keys for higher quotas and private usage are planned and not required today.
Rate limits are planned and will scale with your subscription plan. Please cache responses and paginate rather than polling aggressively.
FWA Lens is an independent analytics platform. It is not affiliated with or endorsed by Fake World Assets. Information displayed by FWA Lens may contain delays, errors or estimates and does not constitute financial, investment, legal or tax advice. Always verify important information directly onchain.