{"uid":"cap_zpAJTQ4DCFlysmTlJIAD3","slug":"point-in-time-universe-18345963","name":"Point-in-time Universe","description":"Top-N Coinbase USD pairs by trailing 20-day dollar volume as of a past date, using only data available that day (survivorship-bias-free universe for backtests).","url":"https://grok-backtest-api.fly.dev/universe?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD (default: last completed day)"},"top_n":{"type":"integer","default":30,"maximum":200,"minimum":1},"min_age_days":{"type":"integer","default":35,"maximum":120,"minimum":0},"min_avg_dollar_volume":{"type":"number","default":1000000,"minimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"date":"2026-07-01","coins":[{"coin":"BTC-USD","rank":1,"close":107000,"age_days":162,"avg_dollar_volume_20d":1100000000}],"count":3,"top_n":3}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ljL06av9WLiJ339Qd-JUd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a survivorship-bias-free ranked list of the top-N crypto coins by dollar volume for a given date, suitable for building backtests and live trading universes.","exampleAgentPrompt":"Give me the top 50 crypto coins by dollar volume as of 2024-11-15, only including coins that have been trading for at least 35 days and have a 20-day average dollar volume above $1,000,000.","exampleUseCases":[{"title":"Historical backtest universe construction","prompt":"I'm running a backtest for October 2023 and need the point-in-time top 100 liquid crypto coins as of 2023-10-01, with a minimum age of 35 days and at least $500,000 in average daily dollar volume — no survivorship bias."},{"title":"Live trading universe screening","prompt":"What are today's top 30 crypto coins by 20-day average dollar volume that have been listed for at least 60 days and trade more than $2,000,000 per day on average?"},{"title":"Portfolio rebalancing eligibility check","prompt":"I need to rebalance my quant crypto portfolio — can you pull the top 20 eligible coins as of 2025-06-01 using a minimum age of 45 days and minimum average dollar volume of $5,000,000?"}],"resultDescription":"A JSON object containing the query date, a ranked array of coins (each with symbol, rank, closing price, age in days, and 20-day average dollar volume), the count of coins returned, and the top_n parameter used. The list is point-in-time accurate and survivorship-bias-free, using Coinbase daily candle data.","failureModes":["Invalid date format (not YYYY-MM-DD) returns a 400 error","Date in the future or before Coinbase data availability returns an empty or error response","top_n out of range (less than 1 or greater than 200) returns a validation error","min_age_days exceeding 120 returns a validation error","Payment not provided or insufficient USDC results in a 402 Payment Required response","Network or server unavailability on fly.dev returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need a historically accurate, survivorship-bias-free ranked universe of crypto coins for a specific date — essential for fair backtesting or live strategy universe construction. Prefer this over generic market cap rankings when you need point-in-time correctness (coins that actually existed and were liquid on that date), when you want to filter by minimum listing age and dollar volume thresholds, or when integrating with the sibling backtest and signals endpoints on the same platform. Not suitable for intraday data, order book information, or non-Coinbase-listed assets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:35:49.825Z","isFirstParty":false,"canonicalSlug":"point-in-time-universe-18345963"}