{
  "name": "pons ledger API",
  "version": "1.1.0",
  "description": "Read-only JSON for the pons launchpad on Robinhood Chain: launches, fees, protocol revenue, burns and the PONS token. Rebuilt hourly from the chain and public sources.",
  "generated_at": "2026-09-28T07:04:41.910Z",
  "status": {
    "maturity": "preview",
    "realtime": false,
    "update_interval_seconds": 3600,
    "summary": "Preview. The figures are real and checked against the chain, but they are hourly snapshots, not a live or streaming feed.",
    "detail": "This is published to find out whether the data is wanted. It runs on a static build refreshed every hour, with source-specific refresh schedules. Scheduling and provider delays can exceed an hour. Today is partial.",
    "if_you_need_more": "Real-time would mean a dedicated indexer reading the chain continuously, with per-trade detail and sub-minute freshness. That is a build, not a config change, and it happens if the usage is there. Say what you need and it will be considered.",
    "contact": {
      "x": "@justinavery",
      "x_url": "https://x.com/justinavery",
      "issues": "https://github.com/justincavery/pons-metrics/issues"
    },
    "affiliation": "Independent and unofficial. Not affiliated with pons, and nothing here is endorsed by them."
  },
  "coverage": {
    "interpretation": "complete means the UTC period ended, not that every source is current, fully priced or finalized.",
    "finality": "provisional; confirmation delay only; canonical reorg recovery pending the event indexer",
    "launches_through": "2026-09-28T07:03:23.000Z",
    "burns_through": "2026-09-28T07:03:23.000Z",
    "closed_day_totals_through": "2026-09-27",
    "metrics": {
      "launches": {
        "first_period": "2026-07-13",
        "last_period": "2026-09-27",
        "data_through": "2026-09-27",
        "periods": 77,
        "periods_available": 77,
        "missing_dates": [],
        "total_is_partial": false
      },
      "fees_usd": {
        "first_period": "2026-07-13",
        "last_period": "2026-09-27",
        "data_through": "2026-09-27",
        "periods": 77,
        "periods_available": 77,
        "missing_dates": [],
        "total_is_partial": false
      },
      "curve_volume_usd": {
        "first_period": "2026-07-13",
        "last_period": "2026-09-27",
        "data_through": "2026-09-27",
        "periods": 77,
        "periods_available": 77,
        "missing_dates": [],
        "total_is_partial": false
      },
      "volume_v2_graduated_usd": {
        "first_period": "2026-07-13",
        "last_period": "2026-09-27",
        "data_through": "2026-09-27",
        "periods": 77,
        "periods_available": 55,
        "missing_dates": [
          "2026-07-13",
          "2026-07-14",
          "2026-07-15",
          "2026-07-16",
          "2026-07-17",
          "2026-07-18",
          "2026-07-19",
          "2026-07-20",
          "2026-07-21",
          "2026-07-22",
          "2026-07-23",
          "2026-07-24",
          "2026-07-25",
          "2026-07-26",
          "2026-07-27",
          "2026-07-28",
          "2026-07-29",
          "2026-07-30",
          "2026-07-31",
          "2026-08-01",
          "2026-08-02",
          "2026-08-03"
        ],
        "total_is_partial": true
      },
      "volume_measured_usd": {
        "first_period": "2026-07-13",
        "last_period": "2026-09-27",
        "data_through": "2026-09-27",
        "periods": 77,
        "periods_available": 77,
        "missing_dates": [],
        "total_is_partial": false
      },
      "pons_price_usd": {
        "first_period": "2026-07-13",
        "last_period": "2026-09-27",
        "data_through": "2026-09-27",
        "periods": 77,
        "periods_available": 77,
        "missing_dates": [],
        "total_is_partial": false
      }
    },
    "sources": [
      {
        "id": "bitquery",
        "status": "cached",
        "data_through": "2026-09-27",
        "last_success_at": "2026-09-27T08:21:03.455Z",
        "next_refresh_at": "2026-09-28T08:21:03.455Z"
      },
      {
        "id": "dune",
        "status": "unavailable",
        "data_through": null,
        "last_success_at": null,
        "next_refresh_at": null
      },
      {
        "id": "dexscreener",
        "status": "healthy",
        "data_through": null,
        "last_success_at": "2026-09-28T07:03:26.554Z",
        "next_refresh_at": "2026-09-28T08:03:26.554Z"
      },
      {
        "id": "coingecko_pons",
        "status": "healthy",
        "data_through": null,
        "last_success_at": "2026-09-28T07:03:26.549Z",
        "next_refresh_at": "2026-09-28T08:03:26.549Z"
      },
      {
        "id": "coingecko_history",
        "status": "cached",
        "data_through": "2026-09-27",
        "last_success_at": "2026-09-27T08:21:04.175Z",
        "next_refresh_at": "2026-09-28T08:21:04.175Z"
      },
      {
        "id": "coingecko_eth",
        "status": "cached",
        "data_through": "2026-09-27",
        "last_success_at": "2026-09-27T08:21:04.835Z",
        "next_refresh_at": "2026-09-28T08:21:04.835Z"
      },
      {
        "id": "coingecko_category",
        "status": "cached",
        "data_through": null,
        "last_success_at": "2026-09-27T08:21:05.458Z",
        "next_refresh_at": "2026-09-28T08:21:05.458Z"
      },
      {
        "id": "blockscout_stats",
        "status": "healthy",
        "data_through": "2026-09-28",
        "last_success_at": "2026-09-28T07:03:26.555Z",
        "next_refresh_at": "2026-09-28T10:03:26.555Z"
      },
      {
        "id": "blockscout_pons",
        "status": "degraded",
        "data_through": null,
        "last_success_at": "2026-09-08T09:50:02.979Z",
        "next_refresh_at": "2026-09-28T08:03:27.413Z"
      },
      {
        "id": "defillama_pons",
        "status": "healthy",
        "data_through": "2026-09-28",
        "last_success_at": "2026-09-28T07:03:26.523Z",
        "next_refresh_at": "2026-09-28T10:03:26.523Z"
      },
      {
        "id": "rpc",
        "status": "healthy",
        "data_through": "2026-09-28T07:03:23.000Z",
        "last_success_at": "2026-09-28T07:03:26.520Z",
        "next_refresh_at": "2026-09-28T07:03:26.520Z"
      },
      {
        "id": "defillama_chain_dex",
        "status": "healthy",
        "data_through": "2026-09-28",
        "last_success_at": "2026-09-28T07:03:29.180Z",
        "next_refresh_at": "2026-09-28T10:03:29.180Z"
      },
      {
        "id": "defillama_chain_fees",
        "status": "healthy",
        "data_through": null,
        "last_success_at": "2026-09-28T07:03:30.301Z",
        "next_refresh_at": "2026-09-28T10:03:30.301Z"
      },
      {
        "id": "defillama_tvl",
        "status": "healthy",
        "data_through": null,
        "last_success_at": "2026-09-28T07:03:30.596Z",
        "next_refresh_at": "2026-09-28T10:03:30.596Z"
      },
      {
        "id": "defillama_eth",
        "status": "healthy",
        "data_through": null,
        "last_success_at": "2026-09-28T07:03:30.633Z",
        "next_refresh_at": "2026-09-28T08:03:30.633Z"
      },
      {
        "id": "geckoterminal",
        "status": "healthy",
        "data_through": null,
        "last_success_at": "2026-09-28T07:03:26.551Z",
        "next_refresh_at": "2026-09-28T08:03:26.551Z"
      },
      {
        "id": "geckoterminal_pons",
        "status": "healthy",
        "data_through": null,
        "last_success_at": "2026-09-28T07:03:33.566Z",
        "next_refresh_at": "2026-09-28T08:03:33.566Z"
      },
      {
        "id": "graduated",
        "status": "healthy",
        "data_through": "2026-09-28",
        "last_success_at": "2026-09-28T07:03:35.561Z",
        "next_refresh_at": "2026-09-28T07:03:35.561Z"
      },
      {
        "id": "quote_prices",
        "status": "healthy",
        "data_through": null,
        "last_success_at": "2026-09-28T07:03:36.586Z",
        "next_refresh_at": "2026-09-28T08:03:36.586Z"
      }
    ]
  },
  "docs": "https://pons-metrics.simplethin.gs/api",
  "source_code": "https://github.com/justincavery/pons-metrics",
  "license": {
    "data": "CC-BY-4.0",
    "code": "MIT",
    "attribution": "pons ledger by Simple Things"
  },
  "contact": {
    "x": "@justinavery",
    "x_url": "https://x.com/justinavery",
    "issues": "https://github.com/justincavery/pons-metrics/issues"
  },
  "disclaimer": "Independent and unofficial. Not affiliated with pons. Nothing here is investment advice. Read /v1/flags before quoting a figure.",
  "stability": "v1 is additive only: fields may be added, never removed or retyped. Breaking changes ship as /v2. The shape is stable even though the service is a preview; if it is ever withdrawn or changed materially, that is announced in the repository first.",
  "parameters": {
    "from": "ISO date, inclusive, on dated collections",
    "to": "ISO date, inclusive, on dated collections",
    "limit": "maximum rows, 1 to 5000",
    "offset": "rows to skip",
    "order": "asc or desc by date, dated collections only",
    "fields": "comma-separated field allow-list",
    "format": "json or csv",
    "pretty": "1 for indented JSON"
  },
  "endpoints": [
    {
      "path": "health",
      "kind": "object",
      "title": "Collection health",
      "description": "Build age and source freshness evaluated when requested. Never cached.",
      "url": "https://pons-metrics.simplethin.gs/v1/health"
    },
    {
      "path": "coverage",
      "kind": "object",
      "title": "Data coverage",
      "description": "Metric cutoffs, missing dates, source observation times and finality limitations.",
      "url": "https://pons-metrics.simplethin.gs/v1/coverage"
    },
    {
      "path": "reconciliation",
      "kind": "collection",
      "dated": true,
      "title": "Volume comparison",
      "description": "Published estimates, sweep-date estimates and external trade-date counts. Different accounting periods; differences are not accuracy scores.",
      "url": "https://pons-metrics.simplethin.gs/v1/reconciliation"
    },
    {
      "path": "upstream-usage",
      "kind": "object",
      "title": "Provider request budgets",
      "description": "Monthly collector requests, retries, cache hits, bytes and conservative request caps. Not a provider invoice.",
      "url": "https://pons-metrics.simplethin.gs/v1/upstream-usage"
    },
    {
      "path": "summary",
      "kind": "object",
      "title": "Summary",
      "description": "The headline figures: launches, fees, protocol revenue, burn and PONS price.",
      "url": "https://pons-metrics.simplethin.gs/v1/summary"
    },
    {
      "path": "protocol",
      "kind": "object",
      "title": "Protocol",
      "description": "Chain, factory addresses with their start blocks, and lifetime totals.",
      "url": "https://pons-metrics.simplethin.gs/v1/protocol"
    },
    {
      "path": "history",
      "kind": "collection",
      "dated": true,
      "title": "Daily ledger",
      "description": "One row per UTC day with every column the ledger keeps. The same data as history.csv.",
      "url": "https://pons-metrics.simplethin.gs/v1/history"
    },
    {
      "path": "launches",
      "kind": "collection",
      "dated": true,
      "title": "Launches per day",
      "description": "Launches split by generation, creators active, first-time creators and V2 graduations.",
      "url": "https://pons-metrics.simplethin.gs/v1/launches"
    },
    {
      "path": "fees",
      "kind": "collection",
      "dated": true,
      "title": "Fees per day",
      "description": "Fees, protocol revenue, holders revenue, supply-side revenue and V2 curve volume in USD.",
      "url": "https://pons-metrics.simplethin.gs/v1/fees"
    },
    {
      "path": "volume",
      "kind": "collection",
      "dated": true,
      "title": "Trading volume per day",
      "description": "Volume through pons pools in USD, split into V1 pools and V2 curves. V1 and graduated volume are fee-derived estimates. Graduated estimates use sweep dates, not trade dates. See /v1/flags.",
      "url": "https://pons-metrics.simplethin.gs/v1/volume"
    },
    {
      "path": "burns",
      "kind": "collection",
      "dated": true,
      "title": "Burns per day",
      "description": "PONS sent to the burn address each day, split into protocol buyback wallet and everyone else.",
      "url": "https://pons-metrics.simplethin.gs/v1/burns"
    },
    {
      "path": "prices",
      "kind": "collection",
      "dated": true,
      "title": "PONS daily price",
      "description": "Daily price, market cap and volume for PONS at 00:00 UTC.",
      "url": "https://pons-metrics.simplethin.gs/v1/prices"
    },
    {
      "path": "token",
      "kind": "object",
      "title": "PONS token",
      "description": "Live snapshot of price, market cap, supply, burn and holders, with every venue it trades on.",
      "url": "https://pons-metrics.simplethin.gs/v1/token"
    },
    {
      "path": "pools",
      "kind": "collection",
      "title": "Pool leaderboards",
      "description": "Busiest pons pools in the last 24 hours, by generation. Filter with ?version=v1|v2.",
      "url": "https://pons-metrics.simplethin.gs/v1/pools"
    },
    {
      "path": "new-pools",
      "kind": "collection",
      "title": "Newest pools",
      "description": "The most recently created pons pools seen by GeckoTerminal.",
      "url": "https://pons-metrics.simplethin.gs/v1/new-pools"
    },
    {
      "path": "quote-assets",
      "kind": "collection",
      "title": "Quote assets",
      "description": "What V2 launches are priced in, by number of launches.",
      "url": "https://pons-metrics.simplethin.gs/v1/quote-assets"
    },
    {
      "path": "chain",
      "kind": "object",
      "title": "Robinhood Chain",
      "description": "Chain activity, TVL, and DEX volume by protocol with the pons share.",
      "url": "https://pons-metrics.simplethin.gs/v1/chain"
    },
    {
      "path": "sources",
      "kind": "collection",
      "title": "Sources",
      "description": "Every upstream source, what it provides, and how fresh it was on the last run.",
      "url": "https://pons-metrics.simplethin.gs/v1/sources"
    },
    {
      "path": "flags",
      "kind": "collection",
      "title": "Flags",
      "description": "Known caveats on the current build, machine readable. Read these before quoting a number.",
      "url": "https://pons-metrics.simplethin.gs/v1/flags"
    }
  ]
}