Take the numbers and build something

/v2/live combines independently dated launch and activity snapshots. /v2/health reports each feed's age and availability. Launch endpoints /v2/launches and /v2/tokens retain the factory census while native history is validated.

/v2/activity serves daily Envio observations. Each row retains date, bucket_start, kind, quote, internal_scope, exact-string swaps and quote_raw, and complete_utc_day. quote_units and volume_usd remain null. Missing groups are not evidence of zero activity.

curl "https://pons-metrics.simplethin.gs/v2/activity?from=2026-09-01&to=2026-09-10&kind=v4&internal_scope=unclassified"

from is inclusive and to exclusive, both UTC dates. Optional kind accepts v3, curve or v4. quote filters a contract address. internal_scope accepts unclassified or hook_internal. Filters apply only to daily; window describes the published observations. Unclassified execution is not proof of user trading. Hook execution is not proof of buybacks.

sync.caught_up compares the indexed block with the snapshot's reported head and is false when stale. It is separate from coverage.validation_complete and coverage.usd_pricing_complete. Read freshness on every request. A missing or invalid native publication returns HTTP 503 from /v2/activity; /v2/live retains launches and reports activity unavailable. A valid stale snapshot stays readable with stale: true.

These responses are direct objects, unlike the /v1 envelope below. revision identifies the indexed block, hash and publication. Replace a previous snapshot when revision changes, including after rollback; do not keep the maximum of old and new totals. /v2/native exposes the underlying native publication and sync status. This is a daily aggregate API, not a per-trade query service.

/v2/stream accepts a WebSocket upgrade for live observed launches, graduations, swap counts and exact raw PONS burn amounts. HTTP GET returns stream health. A private RPC WebSocket relay uses Envio's pool registry, then the Cloudflare Worker broadcasts one-second event batches. No wallet or transaction identities are sent. These transient counts are provisional; disconnect gaps are not replayed and are not a historical ledger. A hello seeds status and price; later pulse frames carry a session, sequence and millisecond receipt timestamp. head supplies the observed chain block, block timestamp in seconds and receipt time. recent_launches supplies up to ten token/quote/version/block/log-index/receipt-time records with nullable contract symbol and block timestamp per batch; wallets and transaction hashes are omitted. Publications check pending heads/events every 100 ms and may coalesce intermediate heads during network delays. Send ping for pong.

The stream's price.pons_weth is the canonical PONS/WETH V3 pool ratio observed on each swap. The dashboard converts it with /v2/market.weth_usd_reference, a dated DexScreener conversion refreshed every 30 seconds. This is not an independent oracle or a historically priced fee series. Stream fields, limits and source definitions.

/v2/market supplies the shared PONS spot quote. One server fetches DexScreener every 30 seconds and selects the PONS-base pair with the highest reported USD liquidity. observed_at is our fetch time; the provider's trade timestamp is unknown. Read freshness.stale before treating a retained quote as current. This quote does not value historical fees or volume.

/v2/boards publishes three GeckoTerminal pool boards. Each board refreshes every 60 seconds with independent observed_at, last_attempt_at, error and request-time freshness. Its data is the provider's top pools by 24h volume, not a complete pool inventory. A failed refresh retains the earlier observation and timestamp.

/v2/holders refreshes GeckoTerminal's PONS holder count every five minutes. data.provider_updated_at records the provider's own update time; observed_at records our fetch. Transfer totals are not provided. These snapshots accept no query parameters and remain independent of Envio accounting.

/v2/market also includes the PONS-base venues returned in the same 30-second DexScreener response and their total_liquidity_usd. Missing numeric fields stay null. Venue coverage is provider-reported. /v2/launches and /v2/live include quote_assets, an all-time V2 census count grouped by quote contract address. Date filters apply only to daily launch rows, not this all-time inventory.

/v2/burns supplies native daily PONS burns, separated by sender and destination, with exact-string amount_raw and events. The token has 18 decimals. Attribution follows the two wallets in DeFiLlama's September 10 burner list, including 0x5795…c324; other senders remain unattributed. A burn alone does not prove a market purchase. The legacy /v1 burn attribution still uses its original wallet. Native coverage remains unverified and the current day is provisional. These two snapshot endpoints accept no query parameters.

curl https://pons-metrics.simplethin.gs/v1/summary

Every response is an envelope. meta tells you when the data was built and what you are allowed to do with it. data is the payload, an object or an array depending on the endpoint.

{
  "meta": {
    "endpoint": "summary",
    "generated_at": "2026-09-04T11:43:37.828Z",
    "docs": "https://pons-metrics.simplethin.gs/api",
    "flags": "https://pons-metrics.simplethin.gs/v1/flags",
    "license": "CC-BY-4.0",
    "attribution": "pons ledger by Simple Things"
  },
  "data": { ... }
}

curl "https://pons-metrics.simplethin.gs/v1/fees?from=2026-08-01&to=2026-08-31&fields=date,fees_usd,revenue_usd"
curl "https://pons-metrics.simplethin.gs/v1/history?order=desc&limit=7&format=csv"
curl "https://pons-metrics.simplethin.gs/v1/pools?version=v2&limit=10"