Skip to content

feat: add GET /snapshot whole-network summary #395

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Miracle656 merged 5 commits into from
Oct 19, 2026
Merged

feat: add GET /snapshot whole-network summary #395

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
a4a6fb4
feat: add GET /snapshot whole-network summary
aliyuHabibu Oct 17, 2026
829c90c
Merge branch 'main' into feat/snapshot-endpoint
aliyuHabibu Oct 18, 2026
7e95f93
Merge branch 'main' into feat/snapshot-endpoint
aliyuHabibu Oct 18, 2026
9222677
m
Miracle656 Oct 19, 2026
595da2a
fix(redis): drop the duplicate config import left by the merge
Miracle656 Oct 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .changeset/snapshot-endpoint.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
'lens': minor
---

Add `GET /snapshot`: one cached, network-scoped summary of a network's venues
(liveness), AMM liquidity (TVL, per-asset reserves and per-pool detail), 24h
traded volume (per venue, with a single-unit total only when the pairs share a
unit), the busiest pairs with their price direction, stablecoin peg readings,
and data freshness. All figures come from a single database statement with one
`as_of` clock, and unknowns are reported as `null` with a reason rather than
invented. The endpoint is public and never 404s.
2 changes: 2 additions & 0 deletions .env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,8 @@ PRICE_POINTS_PRECREATE_DAYS=7
REDIS_URL=redis://localhost:6379
# How long to cache price responses in seconds (default: 10)
PRICE_CACHE_TTL=10
# How long to cache GET /snapshot responses per network in seconds (default: 15)
SNAPSHOT_CACHE_TTL=15
# Default timeout for outbound HTTP requests in milliseconds (default: 10000)
HTTP_TIMEOUT_MS=10000

Expand Down
1 change: 1 addition & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ Aggregates price data from Stellar's Classic Order Book (SDEX) and AMM Liquidity
| GET | `/benchmark/:asset?target=USD` | Peg-deviation statistics versus a target |
| GET | `/basket?asset=XLM&asset=USDC&weight=0.6&weight=0.4` | Weighted price of a basket of assets |
| GET | `/status` | Indexer health |
| GET | `/snapshot?network=testnet\|mainnet` | Whole-network snapshot: venues, TVL, 24h volume, top pairs, peg readings and data freshness in one cached, timestamped object |
| GET | `/discovery/resources?type=&payTo=&network=&extensions=&limit=&offset=` | Bazaar catalog of x402-discoverable resources (spec: [`bazaar`](https://github.com/x402-foundation/x402/blob/main/specs/extensions/bazaar.md)) |
| GET | `/usage/me` | Usage and quota for the calling API key (requires `Authorization: Bearer <key>`) |
| GET | `/supported` | Payment kinds and extensions this facilitator supports |
Expand Down
Loading
Loading