{"openapi":"3.1.0","info":{"title":"Zero1 Public API","version":"0.1.0","description":"Market data for the Zero1 launchpad on Arc (chainId 5042). Zero hidden fees. Zero rugs. Zero snipers. All amounts: USDC fields are human-scale numbers unless suffixed raw (strings, 6-dec USDC / 18-dec token). Rate limit: 100 req/min/IP."},"servers":[{"url":"https://zero1api-production.up.railway.app"}],"paths":{"/health":{"get":{"operationId":"health","summary":"Liveness + DB/indexer status (not rate limited)","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/market/overview":{"get":{"operationId":"marketOverview","summary":"Platform-wide rollups","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"chain":{"type":"string","enum":["arc"]},"chainId":{"type":"integer","enum":[5042]},"totalTokens":{"type":"integer"},"volume24hUsdc":{"type":"number"},"fees24hUsdc":{"type":"number"},"launchFeesTotalUsdc":{"type":"number"},"protocolFeesTotalUsdc":{"type":"number"},"treasuryFeesTotalUsdc":{"type":"number"},"creatorFeesTotalUsdc":{"type":"number"},"bridgeVolumeTotalUsdc":{"type":"number"},"bridgeFeesTotalUsdc":{"type":"number"},"traders24h":{"type":"integer"},"highestMcapUsdc":{"type":"number"},"graduatedCount":{"type":"integer"},"indexedBlock":{"type":"integer"},"updatedAt":{"type":"string","format":"date-time"}}},"updatedAt":{"type":"string","format":"date-time"}}}}}}}}},"/api/v1/tokens":{"get":{"operationId":"listTokens","summary":"Paginated token list","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"sort","in":"query","schema":{"type":"string","enum":["mcap","newest","volume","graduating"],"default":"newest"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"includeHidden","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Requires x-admin-key (currently disabled)"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["address","name","symbol","description","imageUrl","socials","creator","creatorFeeWallet","createdAt","createdBlock","poolAddress","positionNftId","priceUsdc","marketCapUsdc","poolUsdcBalance","volume24hUsdc","fees24hUsdc","trades24h","buyers24h","holders","progressBps","graduated","protection","hidden","flagged","flagReason"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"name":{"type":"string"},"symbol":{"type":"string"},"description":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"socials":{"type":"object","properties":{"website":{"type":"string"},"twitter":{"type":"string"},"telegram":{"type":"string"}}},"creator":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"creatorFeeWallet":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"createdAt":{"type":"string","format":"date-time"},"createdBlock":{"type":"integer"},"poolAddress":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"positionNftId":{"type":["string","null"]},"priceUsdc":{"type":"number","example":0.0000032},"marketCapUsdc":{"type":"number","example":3200},"poolUsdcBalance":{"type":"number","example":3150.5},"volume24hUsdc":{"type":"number"},"fees24hUsdc":{"type":"number"},"trades24h":{"type":"integer"},"buyers24h":{"type":"integer"},"holders":{"type":"integer"},"progressBps":{"type":"integer","minimum":0,"maximum":10000,"description":"ATH-latched: min(allTimeHighPoolUsdc / 9000 * 10000, 10000)"},"graduated":{"type":"boolean","description":"Latches true forever at 9000 USDC pool ATH"},"protection":{"type":"object","properties":{"snipeTaxActive":{"type":"boolean"},"currentTaxBps":{"type":"integer","description":"2500 → 100 linear decay over 1800s"},"taxEndsAt":{"type":["string","null"],"format":"date-time"},"maxWalletActive":{"type":"boolean"},"maxWalletEndsAtBlock":{"type":["integer","null"]}}},"hidden":{"type":"boolean"},"flagged":{"type":"boolean"},"flagReason":{"type":["string","null"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}}},"/api/v1/tokens/{address}":{"get":{"operationId":"getToken","summary":"Single token summary","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["address","name","symbol","description","imageUrl","socials","creator","creatorFeeWallet","createdAt","createdBlock","poolAddress","positionNftId","priceUsdc","marketCapUsdc","poolUsdcBalance","volume24hUsdc","fees24hUsdc","trades24h","buyers24h","holders","progressBps","graduated","protection","hidden","flagged","flagReason"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"name":{"type":"string"},"symbol":{"type":"string"},"description":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"socials":{"type":"object","properties":{"website":{"type":"string"},"twitter":{"type":"string"},"telegram":{"type":"string"}}},"creator":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"creatorFeeWallet":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"createdAt":{"type":"string","format":"date-time"},"createdBlock":{"type":"integer"},"poolAddress":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"positionNftId":{"type":["string","null"]},"priceUsdc":{"type":"number","example":0.0000032},"marketCapUsdc":{"type":"number","example":3200},"poolUsdcBalance":{"type":"number","example":3150.5},"volume24hUsdc":{"type":"number"},"fees24hUsdc":{"type":"number"},"trades24h":{"type":"integer"},"buyers24h":{"type":"integer"},"holders":{"type":"integer"},"progressBps":{"type":"integer","minimum":0,"maximum":10000,"description":"ATH-latched: min(allTimeHighPoolUsdc / 9000 * 10000, 10000)"},"graduated":{"type":"boolean","description":"Latches true forever at 9000 USDC pool ATH"},"protection":{"type":"object","properties":{"snipeTaxActive":{"type":"boolean"},"currentTaxBps":{"type":"integer","description":"2500 → 100 linear decay over 1800s"},"taxEndsAt":{"type":["string","null"],"format":"date-time"},"maxWalletActive":{"type":"boolean"},"maxWalletEndsAtBlock":{"type":["integer","null"]}}},"hidden":{"type":"boolean"},"flagged":{"type":"boolean"},"flagReason":{"type":["string","null"]}}},"updatedAt":{"type":"string","format":"date-time"}}}}}},"404":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tokens/{address}/trades":{"get":{"operationId":"tokenTrades","summary":"Recent trades, newest first","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"blockNumber":{"type":"integer"},"timestamp":{"type":"string","format":"date-time"},"tokenAddress":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"side":{"type":"string","enum":["buy","sell"]},"trader":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"amountToken":{"type":"string","description":"raw 18-dec"},"amountUsdc":{"type":"string","description":"raw 6-dec"},"priceUsdc":{"type":"number"},"snipeTaxUsdc":{"type":"string","description":"raw 6-dec, \"0\" outside window"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}}},"/api/v1/tokens/{address}/candles":{"get":{"operationId":"tokenCandles","summary":"OHLCV candles","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"}},{"name":"interval","in":"query","schema":{"type":"string","enum":["1m","5m","1h"],"default":"5m"}},{"name":"from","in":"query","schema":{"type":"integer"},"description":"unix seconds"},{"name":"to","in":"query","schema":{"type":"integer"},"description":"unix seconds"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","description":"unix seconds, bucket start"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volumeUsdc":{"type":"number"}}}},"updatedAt":{"type":"string","format":"date-time"}}}}}}}}},"/api/v1/tokens/{address}/holders":{"get":{"operationId":"tokenHolders","summary":"Holders by balance (excludes LP pool, vault, burn)","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-f]{40}$","example":"0x3600000000000000000000000000000000000000"},"balance":{"type":"string","description":"raw 18-dec"},"pctSupply":{"type":"number"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}}},"/api/v1/fees/summary":{"get":{"operationId":"feeSummary","summary":"Transparency dashboard: every fee stream + wallets + contracts","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}}},"/api/v1/bridge/config":{"get":{"operationId":"bridgeConfig","summary":"CCTP bridge configuration (domains, fee bps, verification status)","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}}},"/api/v1/uploads":{"post":{"operationId":"uploadImage","summary":"Upload a token image (multipart field 'file'; png/jpeg/webp/gif, max 4.5MB). Returns { imageUrl, ipfsUri, bytes, mime } — pass imageUrl at launch.","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"imageUrl":{"type":"string"},"ipfsUri":{"type":["string","null"]},"bytes":{"type":"integer"},"mime":{"type":"string"}}},"updatedAt":{"type":"string","format":"date-time"}}}}}},"400":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"413":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"415":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/openapi.json":{"get":{"operationId":"openApiDoc","summary":"This document","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}