{"schemaVersion":1,"generatedAt":"2026-11-03T16:57:30.174Z","url":"https://peerlytics.xyz/api/data/catalog","status":"degraded","access":{"authentication":"none","readOnly":true,"chain":"Base","chainId":8453},"semantics":{"updatedAt":"Source computation or retrieval time; generatedAt is only the catalogue response time.","status":"Per-dataset status checks the default published snapshot, not historical exports. Links remain discoverable during outages; a download can return 503. A truncated liquidity snapshot is not complete coverage.","coverage":"Date bounds are inclusive UTC dates; weekly volume ends at the last published closed week. Null means coverage is currently unavailable, not zero activity."},"mcp":{"url":"https://peerlytics.xyz/api/mcp","setup":"https://peerlytics.xyz/connect","tools":["peerlytics_activity","peerlytics_receipt","peerlytics_market"],"scope":"Live activity, individual receipts, 30-day seller rates and current listed liquidity by route. Bulk datasets and historical exports use the HTTP download URLs in this catalogue, not MCP tools."},"datasets":[{"id":"protocol_reports","name":"Volume","description":"Completed Peer fills and USDC volume on Base, aggregated by ISO week.","documentation":"https://peerlytics.xyz/explorer/reports","updatedAt":"2026-11-03T16:30:37.752Z","status":"available","refresh":{"cadence":"Hourly cache revalidation on request","staleAfterSeconds":86400},"coverage":{"firstDay":"2025-01-22","lastDay":"2026-11-01","timezone":"UTC"},"csvColumns":["week","week_start","week_end","partial","days_with_fills","fills","volume_usd","average_fill_usd","vault_fills","vault_volume_usd","vault_fill_share_pct","peak_daily_sellers_filled","fills_rank","volume_rank","rail_difference_fills","computed_at"],"downloads":[{"url":"https://peerlytics.xyz/explorer/reports/weekly.csv","mediaType":"text/csv"}]},{"id":"route_liquidity","name":"Liquidity","description":"Current public USDC liquidity by payment platform and currency, including depth near mid-market.","documentation":"https://peerlytics.xyz/explorer/liquidity","updatedAt":"2026-11-03T16:30:43.545Z","status":"stale","refresh":{"cadence":"Cache revalidation every 2 minutes on request","staleAfterSeconds":600},"coverage":{"asOf":"2026-11-03T16:30:43.545Z","truncated":false},"csvColumns":["platform","platform_id","currency","listed_usdc","deposits","sellers","within_0_5pct_usdc","within_1pct_usdc","within_2pct_usdc","within_2pct_stake_backed_usdc","within_2pct_concentrated","within_3pct_usdc","best_premium_pct","largest_order_within_2pct_usdc","snapshot_reference_quotes","unreferenced_quotes","galleon_delegate_usdc","filled_usdc_per_day_30d","cover_days_within_2pct","figures_suppressed","as_of"],"downloads":[{"url":"https://peerlytics.xyz/explorer/liquidity.json","mediaType":"application/json"},{"url":"https://peerlytics.xyz/explorer/liquidity.csv","mediaType":"text/csv"}]},{"id":"seller_rates","name":"Seller rates","description":"Realised seller premiums against mid-market by payment platform and currency; gross before payment-app fees, not quotes.","documentation":"https://peerlytics.xyz/explorer/seller-rates","updatedAt":"2026-11-03T01:00:02.745Z","status":"available","refresh":{"cadence":"Daily","staleAfterSeconds":259200},"coverage":{"days":30,"firstDay":"2026-10-04","lastDay":"2026-11-02","timezone":"UTC"},"csvColumns":["platform","platform_id","currency","status","fills","usdc_volume","distinct_sellers","median_premium_pct","p25_premium_pct","p75_premium_pct","at_or_below_mid_share_pct","median_signal_to_fulfil_seconds","p90_signal_to_fulfil_seconds","galleon_delegate_fill_share_pct","cross_check_median_premium_pct","references_disagree","withheld_reasons","window_start","window_end","reference","computed_at"],"downloads":[{"url":"https://peerlytics.xyz/explorer/seller-rates.csv","mediaType":"text/csv"}]}],"historicalExports":{"availability":"not_checked","description":"Computed on request. Read returned coverage and timestamps before interpreting results; rate queries can return 429 or 503 while busy.","volume":{"access":{"tier":"free","period":"all"},"documentation":"https://peerlytics.xyz/explorer/data/history?dataset=volume&period=all","downloads":[{"url":"https://peerlytics.xyz/explorer/data/export?dataset=volume&period=all&format=json","mediaType":"application/json"},{"url":"https://peerlytics.xyz/explorer/data/export?dataset=volume&period=all&format=csv","mediaType":"text/csv"}]},"sellerRates":{"access":{"tier":"free","maxDays":90,"firstDay":"2026-08-05","lastDay":"2026-11-02","timezone":"UTC","paidHistory":{"dataset":"seller-rates-weekly","url":"https://peerlytics.xyz/api/data/paid/seller-rates-weekly/all.json"}},"description":"Exact-period aggregates within the latest 90 completed UTC days, free. Longer history uses the paid weekly seller-rate dataset; published 30-day rates remain free.","documentation":"https://peerlytics.xyz/explorer/data/history?dataset=rates&period=90d","downloads":[{"url":"https://peerlytics.xyz/explorer/data/export?dataset=rates&period=90d&format=json","mediaType":"application/json"},{"url":"https://peerlytics.xyz/explorer/data/export?dataset=rates&period=90d&format=csv","mediaType":"text/csv"}]},"liquidity":{"documentation":"https://peerlytics.xyz/explorer/data/liquidity-history","coverage":"Retained observations only; never reconstructed from current balances. Read the export's coverage for actual bounds.","downloads":[{"url":"https://peerlytics.xyz/explorer/data/liquidity-history/export?period=all&format=json","mediaType":"application/json"},{"url":"https://peerlytics.xyz/explorer/data/liquidity-history/export?period=all&format=csv","mediaType":"text/csv"}]},"parameters":{"period":["7d","30d","90d","1y","all","custom"],"customDates":"Use period=custom&from=YYYY-MM-DD&to=YYYY-MM-DD. Dates are clamped to source coverage and, for free seller rates, the latest 90 completed UTC days. Non-overlapping seller-rate periods return 400; all and 1y resolve to the recent free window.","platform":"Optional payment platform slug for volume and seller rates.","currency":"Optional fiat currency code for volume and seller rates.","interval":"day, week or month; applies to volume only.","format":"csv or json"}},"paid":{"payment":{"protocol":"x402","x402Version":2,"network":"eip155:8453","asset":"USDC","payTo":"0xC141Cbe4f4a9CAbc3cc78159a9268a4e008922CD"},"updatedAt":"2026-11-03T01:00:02.745Z","refresh":"Daily after 01:00 UTC","datasets":[{"id":"liquidity-depth","name":"Liquidity depth history","description":"Hourly observations of public USDC liquidity per payment platform and currency: listed depth, sellers, best premium, largest order near mid-market and depth within 0.5%, 1%, 2% and 3% of mid-market. Past hours cannot be reconstructed, so coverage starts at the first observation.","columns":["observed_at","platform_id","currency","listed_usdc","deposits","sellers","best_premium_pct","largest_order_within_2pct_usdc","usdc_within_0_5pct","sellers_within_0_5pct","usdc_within_1pct","sellers_within_1pct","usdc_within_2pct","sellers_within_2pct","usdc_within_3pct","sellers_within_3pct"],"files":[{"id":"2026-10","rows":14406,"from":"2026-10-14T10:54:44.529Z","to":"2026-10-31T23:00:59.025Z","price":"$0.25","downloads":[{"format":"csv","url":"https://peerlytics.xyz/api/data/paid/liquidity-depth/2026-10.csv"},{"format":"json","url":"https://peerlytics.xyz/api/data/paid/liquidity-depth/2026-10.json"}]},{"id":"2026-11","rows":1702,"from":"2026-11-01T00:01:00.968Z","to":"2026-11-03T01:00:50.111Z","price":"$0.25","downloads":[{"format":"csv","url":"https://peerlytics.xyz/api/data/paid/liquidity-depth/2026-11.csv"},{"format":"json","url":"https://peerlytics.xyz/api/data/paid/liquidity-depth/2026-11.json"}]},{"id":"all","rows":16108,"from":"2026-10-14T10:54:44.529Z","to":"2026-11-03T01:00:50.111Z","price":"$1","downloads":[{"format":"csv","url":"https://peerlytics.xyz/api/data/paid/liquidity-depth/all.csv"},{"format":"json","url":"https://peerlytics.xyz/api/data/paid/liquidity-depth/all.json"}]}]},{"id":"seller-rates-weekly","name":"Weekly seller rates","description":"Realised seller premiums against the raw Peer onchain oracle at each fill's signal block for every ISO week since the first Base fill, per route and per currency. Route-weeks that fail the publishing rules keep only the reason; a currency-week aggregates only that week's published routes, so it never reveals a withheld one.","columns":["week","week_start","scope","reference_id","platform_id","currency","status","withheld_reasons","fills","usdc_volume","distinct_sellers","median_premium_pct","p25_premium_pct","p75_premium_pct","at_or_below_mid_share_pct","median_signal_to_fulfil_seconds","p90_signal_to_fulfil_seconds","galleon_delegate_fill_share_pct"],"files":[{"id":"all","rows":1402,"from":"2025-01-20","to":"2026-10-26","price":"$1","downloads":[{"format":"csv","url":"https://peerlytics.xyz/api/data/paid/seller-rates-weekly/all.csv"},{"format":"json","url":"https://peerlytics.xyz/api/data/paid/seller-rates-weekly/all.json"}]}]}],"mcp":{"url":"https://peerlytics.xyz/api/mcp/data","tools":[{"name":"peerlytics_paid_datasets","price":null},{"name":"peerlytics_weekly_seller_rates","price":"$0.05"},{"name":"peerlytics_liquidity_depth","price":"$0.05"}]}}}