{ "openapi": "3.1.0", "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "info": { "title": "Rearctor Read API", "version": "0.2.0", "description": "Read-only SQLite-backed discovery and analytics for the configured Rearctor launchpad. All routes support GET and HEAD; no authentication or signing is involved. Amounts and chain quantities use unsigned decimal strings. Mode/status and truncation must be honored. Examples are clearly labeled synthetic demo data. Unknown/repeated query parameters are rejected. The production proxy handles OPTIONS and may emit non-JSON errors, applies per-visitor rate limits, and permits browser CORS from https://rearctor.io only." }, "servers": [ { "url": "https://api.rearctor.io/api", "description": "Arc Mainnet read index; may be in demo mode." }, { "url": "https://api.rearctor.io/api/testnet", "description": "Arc Testnet (5042002) read index; separately configured." }, { "url": "https://api.rearctor.io/api/testnet-v1", "description": "Previous immutable Arc Testnet deployment; separate catalogue and treasury." } ], "security": [], "tags": [ { "name": "Status" }, { "name": "Discovery" }, { "name": "Market data" }, { "name": "Analytics" } ], "paths": { "/health": { "get": { "operationId": "getIndexHealth", "summary": "Check saved-snapshot readiness", "description": "200 means a readable saved snapshot exists, including stale or demo data. Inspect state and updatedAt for freshness. 503 health bodies contain ok/ready/status, not the normal error envelope.", "tags": [ "Status" ], "parameters": [], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Health" }, "examples": { "illustrativeDemo": { "summary": "Illustrative saved demo data, not live blockchain activity", "description": "Synthetic example based on the versioned demo fixture. Timestamps and readiness are not current service facts.", "value": { "ok": true, "ready": true, "status": { "mode": "demo", "state": "ready", "chainId": 5042, "factory": null, "treasuryAddress": null, "indexedBlock": null, "headBlock": null, "updatedAt": 1789560000000, "error": null } } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "414": { "$ref": "#/components/responses/URITooLong" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "description": "No usable saved snapshot; ok and ready are false. This is not an error envelope.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Health" } } } } } }, "head": { "operationId": "getIndexHealthHead", "summary": "Check saved-snapshot readiness (headers only)", "description": "Same lookup, validation and status code as GET, without a response body. Content-Length describes the corresponding GET JSON body.", "tags": [ "Status" ], "parameters": [], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "400": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "404": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "405": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } } }, "414": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "429": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope.", "headers": {} }, "503": { "description": "No usable saved snapshot; ok and ready are false. This is not an error envelope.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } } } } }, "/tokens": { "get": { "operationId": "listTokens", "summary": "Search the canonical factory catalogue", "description": "Search and sort all indexed factory launches before pagination. Only this configured factory is covered, not every Arc token. summary covers the entire catalogue; total covers query matches. officialUpcoming is separate metadata, not a fake token row. No canonical-only query toggle exists: factory scope is inherent.", "tags": [ "Discovery" ], "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200, "default": "" }, "description": "Trimmed literal substring match over name, symbol, token address and canonical pool address. ASCII case-insensitive; %, _ and backslash are literal. Embedded control characters are rejected." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 24 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "maximum": 1000000000 }, "description": "Offset pagination. Pages can shift between independent snapshot reads." }, { "name": "filter", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "all", "charging", "ignited" ], "default": "all" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "newest", "volume", "marketcap" ], "default": "newest" }, "description": "Global descending order; newest uses creation time, volume uses the pool counter, marketcap uses approximate price × current supply; ties use descending launch ID." } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Catalogue" }, "examples": { "illustrativeDemo": { "summary": "Illustrative saved demo data, not live blockchain activity", "description": "Synthetic example based on the versioned demo fixture. Timestamps and readiness are not current service facts.", "value": { "items": [ { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } ], "total": 1, "status": { "mode": "demo", "state": "ready", "chainId": 5042, "factory": null, "treasuryAddress": null, "indexedBlock": null, "headBlock": null, "updatedAt": 1789560000000, "error": null }, "config": { "count": 6, "quote": "0x0000000000000000000000000000000000000000", "minimumSeed": "1000000", "threshold": "5042000000", "owner": "0x0000000000000000000000000000000000000000" }, "summary": { "count": 6, "volume": "166280000000", "approaching": 2, "graduated": 1 }, "officialUpcoming": false, "limit": 24, "offset": 0 } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "414": { "$ref": "#/components/responses/URITooLong" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/Unavailable" } } }, "head": { "operationId": "listTokensHead", "summary": "Search the canonical factory catalogue (headers only)", "description": "Same lookup, validation and status code as GET, without a response body. Content-Length describes the corresponding GET JSON body.", "tags": [ "Discovery" ], "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200, "default": "" }, "description": "Trimmed literal substring match over name, symbol, token address and canonical pool address. ASCII case-insensitive; %, _ and backslash are literal. Embedded control characters are rejected." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 24 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "maximum": 1000000000 }, "description": "Offset pagination. Pages can shift between independent snapshot reads." }, { "name": "filter", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "all", "charging", "ignited" ], "default": "all" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "newest", "volume", "marketcap" ], "default": "newest" }, "description": "Global descending order; newest uses creation time, volume uses the pool counter, marketcap uses approximate price × current supply; ties use descending launch ID." } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "400": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "404": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "405": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } } }, "414": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "429": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope.", "headers": {} }, "503": { "description": "No snapshot yet, history unavailable, or an indexed-data read failed. A stale readable snapshot instead uses HTTP 200.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Retry-After": { "description": "Present with INDEX_NOT_READY; value 5 seconds. Not guaranteed for other failures.", "schema": { "type": "string", "const": "5" } } } } } } }, "/tokens/{identifier}": { "get": { "operationId": "getToken", "summary": "Read a token and its fee budgets", "description": "No query parameters. Token data is a saved snapshot, not a trading quote. After graduation reserve fields are recorded migration amounts. graduationTransfer is an always-present nullable record of the manual-graduation transfer to dead; it never reduces totalSupply or counts as a fee-funded burn.", "tags": [ "Market data" ], "parameters": [ { "name": "identifier", "in": "path", "required": true, "description": "Zero-based launch ID (canonical decimal, no leading zeroes; <=9,007,199,254,740,991) or exact token/canonical pool address. Names, symbols, creator/vault addresses and the website alias rearctor are not accepted.", "schema": { "type": "string", "pattern": "^(0|[1-9][0-9]*|0x[0-9a-fA-F]{40})$" } } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenDetail" }, "examples": { "illustrativeDemo": { "summary": "Illustrative saved demo data, not live blockchain activity", "description": "Synthetic example based on the versioned demo fixture. Timestamps and readiness are not current service facts.", "value": { "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } }, "metric": { "spent": "1846000000", "burned": "18640000000000000000000000", "executions": "24", "quoteBudget": "328000000", "tokenBudget": "134820000000000000000000", "supply": "981360000000000000000000000", "protocolQuoteAccrued": "3322800000", "protocolQuoteClaimed": "2584400000", "protocolTokenAccrued": "240000000000000000000000", "protocolTokenClaimed": "180000000000000000000000", "liquidityTokenBudget": "0", "liquidityQuoteBudget": "0" }, "status": { "mode": "demo", "state": "ready", "chainId": 5042, "factory": null, "treasuryAddress": null, "indexedBlock": null, "headBlock": null, "updatedAt": 1789560000000, "error": null }, "graduationTransfer": null } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "414": { "$ref": "#/components/responses/URITooLong" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/Unavailable" } } }, "head": { "operationId": "getTokenHead", "summary": "Read a token and its fee budgets (headers only)", "description": "Same lookup, validation and status code as GET, without a response body. Content-Length describes the corresponding GET JSON body.", "tags": [ "Market data" ], "parameters": [ { "name": "identifier", "in": "path", "required": true, "description": "Zero-based launch ID (canonical decimal, no leading zeroes; <=9,007,199,254,740,991) or exact token/canonical pool address. Names, symbols, creator/vault addresses and the website alias rearctor are not accepted.", "schema": { "type": "string", "pattern": "^(0|[1-9][0-9]*|0x[0-9a-fA-F]{40})$" } } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "400": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "404": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "405": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } } }, "414": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "429": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope.", "headers": {} }, "503": { "description": "No snapshot yet, history unavailable, or an indexed-data read failed. A stale readable snapshot instead uses HTTP 200.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Retry-After": { "description": "Present with INDEX_NOT_READY; value 5 seconds. Not guaranteed for other failures.", "schema": { "type": "string", "const": "5" } } } } } } }, "/tokens/{identifier}/history": { "get": { "operationId": "getTokenHistory", "summary": "Read recent priced executions", "description": "Latest up to 5,000 priced curve/canonical V4 executions, oldest-to-newest within the returned window. No query pagination or custom range. V4 covers all routers for that canonical pool. Inspect totalExecutions and truncated.", "tags": [ "Market data" ], "parameters": [ { "name": "identifier", "in": "path", "required": true, "description": "Zero-based launch ID (canonical decimal, no leading zeroes; <=9,007,199,254,740,991) or exact token/canonical pool address. Names, symbols, creator/vault addresses and the website alias rearctor are not accepted.", "schema": { "type": "string", "pattern": "^(0|[1-9][0-9]*|0x[0-9a-fA-F]{40})$" } } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HistoryEnvelope" }, "examples": { "illustrativeDemo": { "summary": "Illustrative saved demo data, not live blockchain activity", "description": "Synthetic example based on the versioned demo fixture. Timestamps and readiness are not current service facts.", "value": { "history": { "pool": "0x0000000000000000000000000000000000000000", "sample": true, "fromBlock": "10000", "toBlock": "10041", "fromTimestamp": 1789540320, "snapshotTimestamp": 1789560000, "fetchedAt": 1789560000000, "omittedZeroAmountSwaps": 0, "executions": [ { "id": "sample:0:sample-0-0", "blockNumber": "10000", "logIndex": 0, "timestamp": 1789540320, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "35000000", "tokenAmount": "2076023752558847562439676", "price": 0.000016859151999999998 }, { "id": "sample:0:sample-0-1", "blockNumber": "10000", "logIndex": 1, "timestamp": 1789540320, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "141000000", "tokenAmount": "8045564140977684401049118", "price": 0.000017525185 }, { "id": "sample:0:sample-0-2", "blockNumber": "10001", "logIndex": 0, "timestamp": 1789540800, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "111000000", "tokenAmount": "6118834715886793619808354", "price": 0.000018140709 }, { "id": "sample:0:sample-0-3", "blockNumber": "10001", "logIndex": 1, "timestamp": 1789540800, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "136000000", "tokenAmount": "7487234128178475402041075", "price": 0.000018164251 }, { "id": "sample:0:sample-0-4", "blockNumber": "10002", "logIndex": 0, "timestamp": 1789541280, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "60000000", "tokenAmount": "3231384237760081999606417", "price": 0.000018567894000000003 }, { "id": "sample:0:sample-0-5", "blockNumber": "10002", "logIndex": 1, "timestamp": 1789541280, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "226000000", "tokenAmount": "12289021026678105243937339", "price": 0.000018390399 }, { "id": "sample:0:sample-0-6", "blockNumber": "10003", "logIndex": 0, "timestamp": 1789541760, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "234000000", "tokenAmount": "13012923278696109536337309", "price": 0.000017982124 }, { "id": "sample:0:sample-0-7", "blockNumber": "10003", "logIndex": 1, "timestamp": 1789541760, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "193000000", "tokenAmount": "11019977105854816769184809", "price": 0.000017513648 }, { "id": "sample:0:sample-0-8", "blockNumber": "10004", "logIndex": 0, "timestamp": 1789542240, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "189000000", "tokenAmount": "10966730016456477777604347", "price": 0.000017233943000000002 }, { "id": "sample:0:sample-0-9", "blockNumber": "10004", "logIndex": 1, "timestamp": 1789542240, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "150000000", "tokenAmount": "8897748146035537131548698", "price": 0.000016858198 }, { "id": "sample:0:sample-0-10", "blockNumber": "10005", "logIndex": 0, "timestamp": 1789542720, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "98000000", "tokenAmount": "5985843358297557739261794", "price": 0.000016371961999999998 }, { "id": "sample:0:sample-0-11", "blockNumber": "10005", "logIndex": 1, "timestamp": 1789542720, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "36000000", "tokenAmount": "2141625453266103744382248", "price": 0.000016809662 }, { "id": "sample:0:sample-0-12", "blockNumber": "10006", "logIndex": 0, "timestamp": 1789543200, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "225000000", "tokenAmount": "13011186381948754199143551", "price": 0.000017292812 }, { "id": "sample:0:sample-0-13", "blockNumber": "10006", "logIndex": 1, "timestamp": 1789543200, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "143000000", "tokenAmount": "8085364715253526788028933", "price": 0.000017686276999999997 }, { "id": "sample:0:sample-0-14", "blockNumber": "10007", "logIndex": 0, "timestamp": 1789543680, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "32000000", "tokenAmount": "1780713382717709183461668", "price": 0.000017970326 }, { "id": "sample:0:sample-0-15", "blockNumber": "10007", "logIndex": 1, "timestamp": 1789543680, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "83000000", "tokenAmount": "4364068927471698224318190", "price": 0.000019018948 }, { "id": "sample:0:sample-0-16", "blockNumber": "10008", "logIndex": 0, "timestamp": 1789544160, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "195000000", "tokenAmount": "9983493445529368596260920", "price": 0.000019532241 }, { "id": "sample:0:sample-0-17", "blockNumber": "10008", "logIndex": 1, "timestamp": 1789544160, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "114000000", "tokenAmount": "5896265755248801467611579", "price": 0.000019334270999999996 }, { "id": "sample:0:sample-0-18", "blockNumber": "10009", "logIndex": 0, "timestamp": 1789544640, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "194000000", "tokenAmount": "9894998761595000352955625", "price": 0.000019605863999999996 }, { "id": "sample:0:sample-0-19", "blockNumber": "10009", "logIndex": 1, "timestamp": 1789544640, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "85000000", "tokenAmount": "4417005658859791041335586", "price": 0.000019243806 }, { "id": "sample:0:sample-0-20", "blockNumber": "10010", "logIndex": 0, "timestamp": 1789545120, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "224000000", "tokenAmount": "11701283573346335688199239", "price": 0.000019143199 }, { "id": "sample:0:sample-0-21", "blockNumber": "10010", "logIndex": 1, "timestamp": 1789545120, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "45000000", "tokenAmount": "2465065097439093171572474", "price": 0.000018255096000000003 }, { "id": "sample:0:sample-0-22", "blockNumber": "10011", "logIndex": 0, "timestamp": 1789545600, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "29000000", "tokenAmount": "1625171007218225048749526", "price": 0.000017844276 }, { "id": "sample:0:sample-0-23", "blockNumber": "10011", "logIndex": 1, "timestamp": 1789545600, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "204000000", "tokenAmount": "11284235624132731817196710", "price": 0.000018078318000000002 }, { "id": "sample:0:sample-0-24", "blockNumber": "10012", "logIndex": 0, "timestamp": 1789546080, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "69000000", "tokenAmount": "3790591049832208663137644", "price": 0.000018202966000000002 }, { "id": "sample:0:sample-0-25", "blockNumber": "10012", "logIndex": 1, "timestamp": 1789546080, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "68000000", "tokenAmount": "3709348742549868511769463", "price": 0.000018332058999999998 }, { "id": "sample:0:sample-0-26", "blockNumber": "10013", "logIndex": 0, "timestamp": 1789546560, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "80000000", "tokenAmount": "4277994796888828283962599", "price": 0.000018700349999999998 }, { "id": "sample:0:sample-0-27", "blockNumber": "10013", "logIndex": 1, "timestamp": 1789546560, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "151000000", "tokenAmount": "7796726634681843468372294", "price": 0.000019367102 }, { "id": "sample:0:sample-0-28", "blockNumber": "10014", "logIndex": 0, "timestamp": 1789547040, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "135000000", "tokenAmount": "6883171471732191399890236", "price": 0.000019613052000000002 }, { "id": "sample:0:sample-0-29", "blockNumber": "10014", "logIndex": 1, "timestamp": 1789547040, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "167000000", "tokenAmount": "8317180406117460500863592", "price": 0.00002007892 }, { "id": "sample:0:sample-0-30", "blockNumber": "10015", "logIndex": 0, "timestamp": 1789547520, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "23000000", "tokenAmount": "1093371813682787641761003", "price": 0.000021035845 }, { "id": "sample:0:sample-0-31", "blockNumber": "10015", "logIndex": 1, "timestamp": 1789547520, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "34000000", "tokenAmount": "1642173408778643670056643", "price": 0.000020704269 }, { "id": "sample:0:sample-0-32", "blockNumber": "10016", "logIndex": 0, "timestamp": 1789548000, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "39000000", "tokenAmount": "1857061765445766011074659", "price": 0.000021000917 }, { "id": "sample:0:sample-0-33", "blockNumber": "10016", "logIndex": 1, "timestamp": 1789548000, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "184000000", "tokenAmount": "8968387797767534319193110", "price": 0.000020516507999999998 }, { "id": "sample:0:sample-0-34", "blockNumber": "10017", "logIndex": 0, "timestamp": 1789548480, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "221000000", "tokenAmount": "11154001020919152267658878", "price": 0.000019813518000000002 }, { "id": "sample:0:sample-0-35", "blockNumber": "10017", "logIndex": 1, "timestamp": 1789548480, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "184000000", "tokenAmount": "9312696667451497552481600", "price": 0.000019757972 }, { "id": "sample:0:sample-0-36", "blockNumber": "10018", "logIndex": 0, "timestamp": 1789548960, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "108000000", "tokenAmount": "5578890470263274040058913", "price": 0.000019358688000000002 }, { "id": "sample:0:sample-0-37", "blockNumber": "10018", "logIndex": 1, "timestamp": 1789548960, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "187000000", "tokenAmount": "9605614034510967916119052", "price": 0.000019467782 }, { "id": "sample:0:sample-0-38", "blockNumber": "10019", "logIndex": 0, "timestamp": 1789549440, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "105000000", "tokenAmount": "5462172065494876430581879", "price": 0.000019223122000000003 }, { "id": "sample:0:sample-0-39", "blockNumber": "10019", "logIndex": 1, "timestamp": 1789549440, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "45000000", "tokenAmount": "2319469981522586689417402", "price": 0.000019400984000000002 }, { "id": "sample:0:sample-0-40", "blockNumber": "10020", "logIndex": 0, "timestamp": 1789549920, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "178000000", "tokenAmount": "8970038961213047596941680", "price": 0.000019843838 }, { "id": "sample:0:sample-0-41", "blockNumber": "10020", "logIndex": 1, "timestamp": 1789549920, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "170000000", "tokenAmount": "8253282961767297813015951", "price": 0.000020597864 }, { "id": "sample:0:sample-0-42", "blockNumber": "10021", "logIndex": 0, "timestamp": 1789550400, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "87000000", "tokenAmount": "4032782348650721416090662", "price": 0.000021573195000000002 }, { "id": "sample:0:sample-0-43", "blockNumber": "10021", "logIndex": 1, "timestamp": 1789550400, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "166000000", "tokenAmount": "7519908731864335772803806", "price": 0.000022074736 }, { "id": "sample:0:sample-0-44", "blockNumber": "10022", "logIndex": 0, "timestamp": 1789550880, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "234000000", "tokenAmount": "10509788992630886284666976", "price": 0.000022264956999999997 }, { "id": "sample:0:sample-0-45", "blockNumber": "10022", "logIndex": 1, "timestamp": 1789550880, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "154000000", "tokenAmount": "6962321498396473376195614", "price": 0.000022119058999999998 }, { "id": "sample:0:sample-0-46", "blockNumber": "10023", "logIndex": 0, "timestamp": 1789551360, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "210000000", "tokenAmount": "9511520466821801075245683", "price": 0.000022078489 }, { "id": "sample:0:sample-0-47", "blockNumber": "10023", "logIndex": 1, "timestamp": 1789551360, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "145000000", "tokenAmount": "6617571889649935010880200", "price": 0.00002191136 }, { "id": "sample:0:sample-0-48", "blockNumber": "10024", "logIndex": 0, "timestamp": 1789551840, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "169000000", "tokenAmount": "7868139663110469286111583", "price": 0.000021479029 }, { "id": "sample:0:sample-0-49", "blockNumber": "10024", "logIndex": 1, "timestamp": 1789551840, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "15000000", "tokenAmount": "707331800623913803603666", "price": 0.000021206455 }, { "id": "sample:0:sample-0-50", "blockNumber": "10025", "logIndex": 0, "timestamp": 1789552320, "side": "sell", "source": "curve", "actorKind": "sample", "quoteAmount": "58000000", "tokenAmount": "2822548973901252248184590", "price": 0.000020548801999999998 }, { "id": "sample:0:sample-0-51", "blockNumber": "10025", "logIndex": 1, "timestamp": 1789552320, "side": "buy", "source": "curve", "actorKind": "sample", "quoteAmount": "137000000", "tokenAmount": "6623351879202051440624962", "price": 0.000020684391 }, { "id": "sample:0:sample-0-52", "blockNumber": "10026", "logIndex": 0, "timestamp": 1789552800, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "85000000", "tokenAmount": "4160773665024335875663943", "price": 0.000020428893 }, { "id": "sample:0:sample-0-53", "blockNumber": "10026", "logIndex": 1, "timestamp": 1789552800, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "233000000", "tokenAmount": "10898279203810075828636393", "price": 0.000021379521999999998 }, { "id": "sample:0:sample-0-54", "blockNumber": "10027", "logIndex": 0, "timestamp": 1789553280, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "130000000", "tokenAmount": "6080779222856769724492522", "price": 0.000021378839 }, { "id": "sample:0:sample-0-55", "blockNumber": "10027", "logIndex": 1, "timestamp": 1789553280, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "21000000", "tokenAmount": "945968615103749333092126", "price": 0.000022199468 }, { "id": "sample:0:sample-0-56", "blockNumber": "10028", "logIndex": 0, "timestamp": 1789553760, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "122000000", "tokenAmount": "5381996463057799818670833", "price": 0.000022668168 }, { "id": "sample:0:sample-0-57", "blockNumber": "10028", "logIndex": 1, "timestamp": 1789553760, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "222000000", "tokenAmount": "9675568174859657409051075", "price": 0.000022944389 }, { "id": "sample:0:sample-0-58", "blockNumber": "10029", "logIndex": 0, "timestamp": 1789554240, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "131000000", "tokenAmount": "5566844114426438277042198", "price": 0.000023532184 }, { "id": "sample:0:sample-0-59", "blockNumber": "10029", "logIndex": 1, "timestamp": 1789554240, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "60000000", "tokenAmount": "2529986773650811815830962", "price": 0.000023715539 }, { "id": "sample:0:sample-0-60", "blockNumber": "10030", "logIndex": 0, "timestamp": 1789554720, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "232000000", "tokenAmount": "9963249352302902019688067", "price": 0.000023285575999999997 }, { "id": "sample:0:sample-0-61", "blockNumber": "10030", "logIndex": 1, "timestamp": 1789554720, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "169000000", "tokenAmount": "7445667335337524876899768", "price": 0.000022697764000000003 }, { "id": "sample:0:sample-0-62", "blockNumber": "10031", "logIndex": 0, "timestamp": 1789555200, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "12000000", "tokenAmount": "531397511244039214479342", "price": 0.000022581965 }, { "id": "sample:0:sample-0-63", "blockNumber": "10031", "logIndex": 1, "timestamp": 1789555200, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "18000000", "tokenAmount": "828431740515296508836766", "price": 0.000021727801 }, { "id": "sample:0:sample-0-64", "blockNumber": "10032", "logIndex": 0, "timestamp": 1789555680, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "131000000", "tokenAmount": "6058605585562611133210376", "price": 0.000021622137 }, { "id": "sample:0:sample-0-65", "blockNumber": "10032", "logIndex": 1, "timestamp": 1789555680, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "160000000", "tokenAmount": "7410104205053515077871627", "price": 0.000021592139000000003 }, { "id": "sample:0:sample-0-66", "blockNumber": "10033", "logIndex": 0, "timestamp": 1789556160, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "18000000", "tokenAmount": "823003534022897512878747", "price": 0.000021871109 }, { "id": "sample:0:sample-0-67", "blockNumber": "10033", "logIndex": 1, "timestamp": 1789556160, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "220000000", "tokenAmount": "9790758147357140600182375", "price": 0.000022470170000000002 }, { "id": "sample:0:sample-0-68", "blockNumber": "10034", "logIndex": 0, "timestamp": 1789556640, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "196000000", "tokenAmount": "8399500469707780093021039", "price": 0.000023334721 }, { "id": "sample:0:sample-0-69", "blockNumber": "10034", "logIndex": 1, "timestamp": 1789556640, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "97000000", "tokenAmount": "4093101604706813663870276", "price": 0.000023698409999999997 }, { "id": "sample:0:sample-0-70", "blockNumber": "10035", "logIndex": 0, "timestamp": 1789557120, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "174000000", "tokenAmount": "7239266279560077277087285", "price": 0.000024035585 }, { "id": "sample:0:sample-0-71", "blockNumber": "10035", "logIndex": 1, "timestamp": 1789557120, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "28000000", "tokenAmount": "1141908799251495095073491", "price": 0.000024520347 }, { "id": "sample:0:sample-0-72", "blockNumber": "10036", "logIndex": 0, "timestamp": 1789557600, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "199000000", "tokenAmount": "8082349967215714102831535", "price": 0.000024621552 }, { "id": "sample:0:sample-0-73", "blockNumber": "10036", "logIndex": 1, "timestamp": 1789557600, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "61000000", "tokenAmount": "2506178757760320896058331", "price": 0.000024339844000000004 }, { "id": "sample:0:sample-0-74", "blockNumber": "10037", "logIndex": 0, "timestamp": 1789558080, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "178000000", "tokenAmount": "7376246984596448635441963", "price": 0.000024131513000000003 }, { "id": "sample:0:sample-0-75", "blockNumber": "10037", "logIndex": 1, "timestamp": 1789558080, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "88000000", "tokenAmount": "3707866939149942852500800", "price": 0.000023733322000000002 }, { "id": "sample:0:sample-0-76", "blockNumber": "10038", "logIndex": 0, "timestamp": 1789558560, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "223000000", "tokenAmount": "9419718317474413848523495", "price": 0.000023673743999999997 }, { "id": "sample:0:sample-0-77", "blockNumber": "10038", "logIndex": 1, "timestamp": 1789558560, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "146000000", "tokenAmount": "6250679386770676829985930", "price": 0.000023357461 }, { "id": "sample:0:sample-0-78", "blockNumber": "10039", "logIndex": 0, "timestamp": 1789559040, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "18000000", "tokenAmount": "784914056489479731491366", "price": 0.000022932447 }, { "id": "sample:0:sample-0-79", "blockNumber": "10039", "logIndex": 1, "timestamp": 1789559040, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "45000000", "tokenAmount": "1958050806545058947989775", "price": 0.000022982039 }, { "id": "sample:0:sample-0-80", "blockNumber": "10040", "logIndex": 0, "timestamp": 1789559520, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "61000000", "tokenAmount": "2602807704140128339754303", "price": 0.00002343623 }, { "id": "sample:0:sample-0-81", "blockNumber": "10040", "logIndex": 1, "timestamp": 1789559520, "side": "buy", "source": "v4", "actorKind": "sample", "quoteAmount": "201000000", "tokenAmount": "8401505349125599746266178", "price": 0.000023924284 }, { "id": "sample:0:sample-0-82", "blockNumber": "10041", "logIndex": 0, "timestamp": 1789560000, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "103000000", "tokenAmount": "4155197514691648843693249", "price": 0.000024788232 }, { "id": "sample:0:sample-0-83", "blockNumber": "10041", "logIndex": 1, "timestamp": 1789560000, "side": "sell", "source": "v4", "actorKind": "sample", "quoteAmount": "237000000", "tokenAmount": "9441935780096120499817037", "price": 0.000025100784999999998 } ], "totalExecutions": 84, "truncated": false }, "status": { "mode": "demo", "state": "ready", "chainId": 5042, "factory": null, "treasuryAddress": null, "indexedBlock": null, "headBlock": null, "updatedAt": 1789560000000, "error": null } } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "414": { "$ref": "#/components/responses/URITooLong" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/Unavailable" } } }, "head": { "operationId": "getTokenHistoryHead", "summary": "Read recent priced executions (headers only)", "description": "Same lookup, validation and status code as GET, without a response body. Content-Length describes the corresponding GET JSON body.", "tags": [ "Market data" ], "parameters": [ { "name": "identifier", "in": "path", "required": true, "description": "Zero-based launch ID (canonical decimal, no leading zeroes; <=9,007,199,254,740,991) or exact token/canonical pool address. Names, symbols, creator/vault addresses and the website alias rearctor are not accepted.", "schema": { "type": "string", "pattern": "^(0|[1-9][0-9]*|0x[0-9a-fA-F]{40})$" } } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "400": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "404": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "405": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } } }, "414": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "429": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope.", "headers": {} }, "503": { "description": "No snapshot yet, history unavailable, or an indexed-data read failed. A stale readable snapshot instead uses HTTP 200.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Retry-After": { "description": "Present with INDEX_NOT_READY; value 5 seconds. Not guaranteed for other failures.", "schema": { "type": "string", "const": "5" } } } } } } }, "/tokens/{identifier}/burns": { "get": { "operationId": "getTokenBurns", "summary": "Read project-vault buybacks", "description": "Newest-first project Buyback events, with nested launch metadata. Direct holder burns are not these vault buybacks. truncated means later pages remain.", "tags": [ "Analytics" ], "parameters": [ { "name": "identifier", "in": "path", "required": true, "description": "Zero-based launch ID (canonical decimal, no leading zeroes; <=9,007,199,254,740,991) or exact token/canonical pool address. Names, symbols, creator/vault addresses and the website alias rearctor are not accepted.", "schema": { "type": "string", "pattern": "^(0|[1-9][0-9]*|0x[0-9a-fA-F]{40})$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "maximum": 1000000000 }, "description": "Offset pagination. Pages can shift between independent snapshot reads." } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BurnPage" }, "examples": { "illustrativeDemo": { "summary": "Illustrative saved demo data, not live blockchain activity", "description": "Synthetic example based on the versioned demo fixture. Timestamps and readiness are not current service facts.", "value": { "burns": [ { "timestamp": 1789545600, "spent": "18460000", "burned": "186400000000000000000000", "id": "sample:burn:0:3", "block": "0", "index": 3, "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789549200, "spent": "55380000", "burned": "559200000000000000000000", "id": "sample:burn:0:2", "block": "0", "index": 2, "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789552800, "spent": "92300000", "burned": "932000000000000000000000", "id": "sample:burn:0:1", "block": "0", "index": 1, "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789556400, "spent": "129220000", "burned": "1304800000000000000000000", "id": "sample:burn:0:0", "block": "0", "index": 0, "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } } ], "total": 4, "limit": 100, "offset": 0, "truncated": false, "status": { "mode": "demo", "state": "ready", "chainId": 5042, "factory": null, "treasuryAddress": null, "indexedBlock": null, "headBlock": null, "updatedAt": 1789560000000, "error": null } } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "414": { "$ref": "#/components/responses/URITooLong" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/Unavailable" } } }, "head": { "operationId": "getTokenBurnsHead", "summary": "Read project-vault buybacks (headers only)", "description": "Same lookup, validation and status code as GET, without a response body. Content-Length describes the corresponding GET JSON body.", "tags": [ "Analytics" ], "parameters": [ { "name": "identifier", "in": "path", "required": true, "description": "Zero-based launch ID (canonical decimal, no leading zeroes; <=9,007,199,254,740,991) or exact token/canonical pool address. Names, symbols, creator/vault addresses and the website alias rearctor are not accepted.", "schema": { "type": "string", "pattern": "^(0|[1-9][0-9]*|0x[0-9a-fA-F]{40})$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "maximum": 1000000000 }, "description": "Offset pagination. Pages can shift between independent snapshot reads." } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "400": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "404": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "405": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } } }, "414": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "429": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope.", "headers": {} }, "503": { "description": "No snapshot yet, history unavailable, or an indexed-data read failed. A stale readable snapshot instead uses HTTP 200.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Retry-After": { "description": "Present with INDEX_NOT_READY; value 5 seconds. Not guaranteed for other failures.", "schema": { "type": "string", "const": "5" } } } } } } }, "/tokens/{identifier}/holders": { "get": { "operationId": "getTokenHolders", "summary": "Read holder concentration", "description": "Snapshot concentration/top five only; not a complete holder list or a wallet-holdings endpoint. Pool, vault and V4 manager are excluded from ranking. The denominator remains full total supply. null in demo or without saved concentration.", "tags": [ "Market data" ], "parameters": [ { "name": "identifier", "in": "path", "required": true, "description": "Zero-based launch ID (canonical decimal, no leading zeroes; <=9,007,199,254,740,991) or exact token/canonical pool address. Names, symbols, creator/vault addresses and the website alias rearctor are not accepted.", "schema": { "type": "string", "pattern": "^(0|[1-9][0-9]*|0x[0-9a-fA-F]{40})$" } } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldersEnvelope" }, "examples": { "illustrativeDemo": { "summary": "Illustrative saved demo data, not live blockchain activity", "description": "Synthetic example based on the versioned demo fixture. Timestamps and readiness are not current service facts.", "value": { "concentration": null, "status": { "mode": "demo", "state": "ready", "chainId": 5042, "factory": null, "treasuryAddress": null, "indexedBlock": null, "headBlock": null, "updatedAt": 1789560000000, "error": null } } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "414": { "$ref": "#/components/responses/URITooLong" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/Unavailable" } } }, "head": { "operationId": "getTokenHoldersHead", "summary": "Read holder concentration (headers only)", "description": "Same lookup, validation and status code as GET, without a response body. Content-Length describes the corresponding GET JSON body.", "tags": [ "Market data" ], "parameters": [ { "name": "identifier", "in": "path", "required": true, "description": "Zero-based launch ID (canonical decimal, no leading zeroes; <=9,007,199,254,740,991) or exact token/canonical pool address. Names, symbols, creator/vault addresses and the website alias rearctor are not accepted.", "schema": { "type": "string", "pattern": "^(0|[1-9][0-9]*|0x[0-9a-fA-F]{40})$" } } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "400": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "404": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "405": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } } }, "414": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "429": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope.", "headers": {} }, "503": { "description": "No snapshot yet, history unavailable, or an indexed-data read failed. A stale readable snapshot instead uses HTTP 200.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Retry-After": { "description": "Present with INDEX_NOT_READY; value 5 seconds. Not guaranteed for other failures.", "schema": { "type": "string", "const": "5" } } } } } } }, "/analytics": { "get": { "operationId": "getAnalytics", "summary": "Read project fee and burn analytics", "description": "Up to 10,000 metric rows by ascending launch ID plus latest 100 cross-project burns. No pagination parameters. scope and burnScope disclose completeness. Never sum unlike token quantities as one asset.", "tags": [ "Analytics" ], "parameters": [], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Analytics" }, "examples": { "illustrativeDemo": { "summary": "Illustrative saved demo data, not live blockchain activity", "description": "Synthetic example based on the versioned demo fixture. Timestamps and readiness are not current service facts.", "value": { "rows": [ { "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } }, "spent": "1846000000", "burned": "18640000000000000000000000", "executions": "24", "quoteBudget": "328000000", "tokenBudget": "134820000000000000000000", "supply": "981360000000000000000000000", "protocolQuoteAccrued": "3322800000", "protocolQuoteClaimed": "2584400000", "protocolTokenAccrued": "240000000000000000000000", "protocolTokenClaimed": "180000000000000000000000", "liquidityTokenBudget": "0", "liquidityQuoteBudget": "0" }, { "launch": { "id": 1, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789549200", "name": "Nova", "symbol": "NOVA", "description": "Small beginnings. A community with its own gravitational pull.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "4620000000", "volume": "32640000000", "tokens": "219243785354529147394496833", "virtualTokens": "286333732402047413964148253", "virtualReserve": "6300666666", "supply": "1000000000000000000000000000", "price": 0.000022004625906783127, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } }, "spent": "729000000", "burned": "7390000000000000000000000", "executions": "13", "quoteBudget": "164000000", "tokenBudget": "0", "supply": "992610000000000000000000000", "protocolQuoteAccrued": "1312200000", "protocolQuoteClaimed": "1020600000", "protocolTokenAccrued": "0", "protocolTokenClaimed": "0", "liquidityTokenBudget": "0", "liquidityQuoteBudget": "0" }, { "launch": { "id": 2, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789542000", "name": "Particle", "symbol": "PRTCL", "description": "A home for curious minds and onchain experiments.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "3910000000", "volume": "21980000000", "tokens": "255607418200289239061272171", "virtualTokens": "322697365247807505630923591", "virtualReserve": "5590666666", "supply": "1000000000000000000000000000", "price": 0.000017324797993645794, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } }, "spent": "458000000", "burned": "5180000000000000000000000", "executions": "9", "quoteBudget": "112000000", "tokenBudget": "0", "supply": "994820000000000000000000000", "protocolQuoteAccrued": "824400000", "protocolQuoteClaimed": "641200000", "protocolTokenAccrued": "0", "protocolTokenClaimed": "0", "liquidityTokenBudget": "0", "liquidityQuoteBudget": "0" }, { "launch": { "id": 3, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789534800", "name": "Lumen", "symbol": "LUMEN", "description": "Bright ideas deserve a place to begin.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "2830000000", "volume": "18650000000", "tokens": "332871641046684802461876928", "virtualTokens": "399961588094203069031528348", "virtualReserve": "4510666666", "supply": "1000000000000000000000000000", "price": 0.000011277749664644298, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } }, "spent": "283000000", "burned": "3720000000000000000000000", "executions": "7", "quoteBudget": "73000000", "tokenBudget": "0", "supply": "996280000000000000000000000", "protocolQuoteAccrued": "509400000", "protocolQuoteClaimed": "396200000", "protocolTokenAccrued": "0", "protocolTokenClaimed": "0", "liquidityTokenBudget": "0", "liquidityQuoteBudget": "0" }, { "launch": { "id": 4, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789527600", "name": "Parallel", "symbol": "PRL", "description": "Different trajectories. One shared direction.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "1740000000", "volume": "12380000000", "tokens": "460319935075425849410871255", "virtualTokens": "527409882122944115980522675", "virtualReserve": "3420666666", "supply": "1000000000000000000000000000", "price": 0.0000064857841727027235, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } }, "spent": "174000000", "burned": "2150000000000000000000000", "executions": "4", "quoteBudget": "42000000", "tokenBudget": "0", "supply": "997850000000000000000000000", "protocolQuoteAccrued": "313200000", "protocolQuoteClaimed": "243600000", "protocolTokenAccrued": "0", "protocolTokenClaimed": "0", "liquidityTokenBudget": "0", "liquidityQuoteBudget": "0" }, { "launch": { "id": 5, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789520400", "name": "First Light", "symbol": "LIGHT", "description": "For everyone who was here at the first spark.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "610000000", "volume": "6420000000", "tokens": "720494484102947626365035316", "virtualTokens": "787584431150465892934686736", "virtualReserve": "2290666666", "supply": "1000000000000000000000000000", "price": 0.000002908471238637746, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } }, "spent": "61000000", "burned": "830000000000000000000000", "executions": "2", "quoteBudget": "19000000", "tokenBudget": "0", "supply": "999170000000000000000000000", "protocolQuoteAccrued": "109800000", "protocolQuoteClaimed": "85400000", "protocolTokenAccrued": "0", "protocolTokenClaimed": "0", "liquidityTokenBudget": "0", "liquidityQuoteBudget": "0" } ], "burns": [ { "timestamp": 1789545600, "spent": "18460000", "burned": "186400000000000000000000", "id": "sample:burn:0:3", "block": "0", "index": 3, "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789545600, "spent": "7290000", "burned": "73900000000000000000000", "id": "sample:burn:1:3", "block": "0", "index": 3, "launch": { "id": 1, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789549200", "name": "Nova", "symbol": "NOVA", "description": "Small beginnings. A community with its own gravitational pull.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "4620000000", "volume": "32640000000", "tokens": "219243785354529147394496833", "virtualTokens": "286333732402047413964148253", "virtualReserve": "6300666666", "supply": "1000000000000000000000000000", "price": 0.000022004625906783127, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789545600, "spent": "4580000", "burned": "51800000000000000000000", "id": "sample:burn:2:3", "block": "0", "index": 3, "launch": { "id": 2, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789542000", "name": "Particle", "symbol": "PRTCL", "description": "A home for curious minds and onchain experiments.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "3910000000", "volume": "21980000000", "tokens": "255607418200289239061272171", "virtualTokens": "322697365247807505630923591", "virtualReserve": "5590666666", "supply": "1000000000000000000000000000", "price": 0.000017324797993645794, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789545600, "spent": "2830000", "burned": "37200000000000000000000", "id": "sample:burn:3:3", "block": "0", "index": 3, "launch": { "id": 3, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789534800", "name": "Lumen", "symbol": "LUMEN", "description": "Bright ideas deserve a place to begin.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "2830000000", "volume": "18650000000", "tokens": "332871641046684802461876928", "virtualTokens": "399961588094203069031528348", "virtualReserve": "4510666666", "supply": "1000000000000000000000000000", "price": 0.000011277749664644298, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789545600, "spent": "1740000", "burned": "21500000000000000000000", "id": "sample:burn:4:3", "block": "0", "index": 3, "launch": { "id": 4, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789527600", "name": "Parallel", "symbol": "PRL", "description": "Different trajectories. One shared direction.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "1740000000", "volume": "12380000000", "tokens": "460319935075425849410871255", "virtualTokens": "527409882122944115980522675", "virtualReserve": "3420666666", "supply": "1000000000000000000000000000", "price": 0.0000064857841727027235, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789549200, "spent": "55380000", "burned": "559200000000000000000000", "id": "sample:burn:0:2", "block": "0", "index": 2, "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789549200, "spent": "21870000", "burned": "221700000000000000000000", "id": "sample:burn:1:2", "block": "0", "index": 2, "launch": { "id": 1, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789549200", "name": "Nova", "symbol": "NOVA", "description": "Small beginnings. A community with its own gravitational pull.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "4620000000", "volume": "32640000000", "tokens": "219243785354529147394496833", "virtualTokens": "286333732402047413964148253", "virtualReserve": "6300666666", "supply": "1000000000000000000000000000", "price": 0.000022004625906783127, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789549200, "spent": "13740000", "burned": "155400000000000000000000", "id": "sample:burn:2:2", "block": "0", "index": 2, "launch": { "id": 2, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789542000", "name": "Particle", "symbol": "PRTCL", "description": "A home for curious minds and onchain experiments.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "3910000000", "volume": "21980000000", "tokens": "255607418200289239061272171", "virtualTokens": "322697365247807505630923591", "virtualReserve": "5590666666", "supply": "1000000000000000000000000000", "price": 0.000017324797993645794, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789549200, "spent": "8490000", "burned": "111600000000000000000000", "id": "sample:burn:3:2", "block": "0", "index": 2, "launch": { "id": 3, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789534800", "name": "Lumen", "symbol": "LUMEN", "description": "Bright ideas deserve a place to begin.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "2830000000", "volume": "18650000000", "tokens": "332871641046684802461876928", "virtualTokens": "399961588094203069031528348", "virtualReserve": "4510666666", "supply": "1000000000000000000000000000", "price": 0.000011277749664644298, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789549200, "spent": "5220000", "burned": "64500000000000000000000", "id": "sample:burn:4:2", "block": "0", "index": 2, "launch": { "id": 4, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789527600", "name": "Parallel", "symbol": "PRL", "description": "Different trajectories. One shared direction.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "1740000000", "volume": "12380000000", "tokens": "460319935075425849410871255", "virtualTokens": "527409882122944115980522675", "virtualReserve": "3420666666", "supply": "1000000000000000000000000000", "price": 0.0000064857841727027235, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789552800, "spent": "92300000", "burned": "932000000000000000000000", "id": "sample:burn:0:1", "block": "0", "index": 1, "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789552800, "spent": "36450000", "burned": "369500000000000000000000", "id": "sample:burn:1:1", "block": "0", "index": 1, "launch": { "id": 1, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789549200", "name": "Nova", "symbol": "NOVA", "description": "Small beginnings. A community with its own gravitational pull.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "4620000000", "volume": "32640000000", "tokens": "219243785354529147394496833", "virtualTokens": "286333732402047413964148253", "virtualReserve": "6300666666", "supply": "1000000000000000000000000000", "price": 0.000022004625906783127, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789552800, "spent": "22900000", "burned": "259000000000000000000000", "id": "sample:burn:2:1", "block": "0", "index": 1, "launch": { "id": 2, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789542000", "name": "Particle", "symbol": "PRTCL", "description": "A home for curious minds and onchain experiments.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "3910000000", "volume": "21980000000", "tokens": "255607418200289239061272171", "virtualTokens": "322697365247807505630923591", "virtualReserve": "5590666666", "supply": "1000000000000000000000000000", "price": 0.000017324797993645794, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789552800, "spent": "14150000", "burned": "186000000000000000000000", "id": "sample:burn:3:1", "block": "0", "index": 1, "launch": { "id": 3, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789534800", "name": "Lumen", "symbol": "LUMEN", "description": "Bright ideas deserve a place to begin.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "2830000000", "volume": "18650000000", "tokens": "332871641046684802461876928", "virtualTokens": "399961588094203069031528348", "virtualReserve": "4510666666", "supply": "1000000000000000000000000000", "price": 0.000011277749664644298, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789552800, "spent": "8700000", "burned": "107500000000000000000000", "id": "sample:burn:4:1", "block": "0", "index": 1, "launch": { "id": 4, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789527600", "name": "Parallel", "symbol": "PRL", "description": "Different trajectories. One shared direction.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "1740000000", "volume": "12380000000", "tokens": "460319935075425849410871255", "virtualTokens": "527409882122944115980522675", "virtualReserve": "3420666666", "supply": "1000000000000000000000000000", "price": 0.0000064857841727027235, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789552800, "spent": "3050000", "burned": "41500000000000000000000", "id": "sample:burn:5:1", "block": "0", "index": 1, "launch": { "id": 5, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789520400", "name": "First Light", "symbol": "LIGHT", "description": "For everyone who was here at the first spark.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "610000000", "volume": "6420000000", "tokens": "720494484102947626365035316", "virtualTokens": "787584431150465892934686736", "virtualReserve": "2290666666", "supply": "1000000000000000000000000000", "price": 0.000002908471238637746, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789556400, "spent": "129220000", "burned": "1304800000000000000000000", "id": "sample:burn:0:0", "block": "0", "index": 0, "launch": { "id": 0, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789556400", "name": "Helix", "symbol": "HELIX", "description": "An open collective exploring the next frontier on Arc.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "5042000000", "volume": "74210000000", "tokens": "201269841222392102851513604", "virtualTokens": "268359788269910369421165024", "virtualReserve": "6722666666", "supply": "1000000000000000000000000000", "price": 0.00002505094637814548, "threshold": "5042000000", "graduated": true, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789556400, "spent": "51030000", "burned": "517300000000000000000000", "id": "sample:burn:1:0", "block": "0", "index": 0, "launch": { "id": 1, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789549200", "name": "Nova", "symbol": "NOVA", "description": "Small beginnings. A community with its own gravitational pull.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "4620000000", "volume": "32640000000", "tokens": "219243785354529147394496833", "virtualTokens": "286333732402047413964148253", "virtualReserve": "6300666666", "supply": "1000000000000000000000000000", "price": 0.000022004625906783127, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789556400, "spent": "32060000", "burned": "362600000000000000000000", "id": "sample:burn:2:0", "block": "0", "index": 0, "launch": { "id": 2, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789542000", "name": "Particle", "symbol": "PRTCL", "description": "A home for curious minds and onchain experiments.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "3910000000", "volume": "21980000000", "tokens": "255607418200289239061272171", "virtualTokens": "322697365247807505630923591", "virtualReserve": "5590666666", "supply": "1000000000000000000000000000", "price": 0.000017324797993645794, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789556400, "spent": "19810000", "burned": "260400000000000000000000", "id": "sample:burn:3:0", "block": "0", "index": 0, "launch": { "id": 3, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789534800", "name": "Lumen", "symbol": "LUMEN", "description": "Bright ideas deserve a place to begin.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "2830000000", "volume": "18650000000", "tokens": "332871641046684802461876928", "virtualTokens": "399961588094203069031528348", "virtualReserve": "4510666666", "supply": "1000000000000000000000000000", "price": 0.000011277749664644298, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789556400, "spent": "12180000", "burned": "150500000000000000000000", "id": "sample:burn:4:0", "block": "0", "index": 0, "launch": { "id": 4, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789527600", "name": "Parallel", "symbol": "PRL", "description": "Different trajectories. One shared direction.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "1740000000", "volume": "12380000000", "tokens": "460319935075425849410871255", "virtualTokens": "527409882122944115980522675", "virtualReserve": "3420666666", "supply": "1000000000000000000000000000", "price": 0.0000064857841727027235, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } }, { "timestamp": 1789556400, "spent": "4270000", "burned": "58100000000000000000000", "id": "sample:burn:5:0", "block": "0", "index": 0, "launch": { "id": 5, "token": "0x0000000000000000000000000000000000000000", "pool": "0x0000000000000000000000000000000000000000", "vault": "0x0000000000000000000000000000000000000000", "creator": "0x0000000000000000000000000000000000000000", "quote": "0x0000000000000000000000000000000000000000", "createdAt": "1789520400", "name": "First Light", "symbol": "LIGHT", "description": "For everyone who was here at the first spark.", "image": "", "website": "", "socialX": "", "telegram": "", "reserve": "610000000", "volume": "6420000000", "tokens": "720494484102947626365035316", "virtualTokens": "787584431150465892934686736", "virtualReserve": "2290666666", "supply": "1000000000000000000000000000", "price": 0.000002908471238637746, "threshold": "5042000000", "graduated": false, "fees": { "buyBps": 300, "sellBps": 500, "creatorBps": 4000, "buybackBps": 3000, "liquidityBps": 3000, "creatorWallet": "0x0000000000000000000000000000000000000000" } } } ], "total": 6, "status": { "mode": "demo", "state": "ready", "chainId": 5042, "factory": null, "treasuryAddress": null, "indexedBlock": null, "headBlock": null, "updatedAt": 1789560000000, "error": null }, "truncated": false, "scope": { "returned": 6, "total": 6, "metricsTotal": 6, "truncated": false, "complete": true }, "burnScope": { "returned": 22, "total": 22, "truncated": false } } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "414": { "$ref": "#/components/responses/URITooLong" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/Unavailable" } } }, "head": { "operationId": "getAnalyticsHead", "summary": "Read project fee and burn analytics (headers only)", "description": "Same lookup, validation and status code as GET, without a response body. Content-Length describes the corresponding GET JSON body.", "tags": [ "Analytics" ], "parameters": [], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "400": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "404": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "405": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } } }, "414": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "429": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope.", "headers": {} }, "503": { "description": "No snapshot yet, history unavailable, or an indexed-data read failed. A stale readable snapshot instead uses HTTP 200.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Retry-After": { "description": "Present with INDEX_NOT_READY; value 5 seconds. Not guaranteed for other failures.", "schema": { "type": "string", "const": "5" } } } } } } }, "/treasury": { "get": { "operationId": "getTreasury", "summary": "Read protocol treasury and Rearctor buybacks", "description": "snapshot may be null. Burns are protocol-funded Rearctor buybacks, separate from project-vault burns, and do not include nested launch metadata. Resolve official identity via /official.", "tags": [ "Analytics" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "maximum": 1000000000 }, "description": "Offset pagination. Pages can shift between independent snapshot reads." } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TreasuryEnvelope" }, "examples": { "illustrativeDemo": { "summary": "Illustrative saved demo data, not live blockchain activity", "description": "Synthetic example based on the versioned demo fixture. Timestamps and readiness are not current service facts.", "value": { "snapshot": null, "burns": [], "total": 0, "limit": 100, "offset": 0, "truncated": false, "status": { "mode": "demo", "state": "ready", "chainId": 5042, "factory": null, "treasuryAddress": null, "indexedBlock": null, "headBlock": null, "updatedAt": 1789560000000, "error": null } } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "414": { "$ref": "#/components/responses/URITooLong" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/Unavailable" } } }, "head": { "operationId": "getTreasuryHead", "summary": "Read protocol treasury and Rearctor buybacks (headers only)", "description": "Same lookup, validation and status code as GET, without a response body. Content-Length describes the corresponding GET JSON body.", "tags": [ "Analytics" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "maximum": 1000000000 }, "description": "Offset pagination. Pages can shift between independent snapshot reads." } ], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "400": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "404": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "405": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } } }, "414": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "429": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope.", "headers": {} }, "503": { "description": "No snapshot yet, history unavailable, or an indexed-data read failed. A stale readable snapshot instead uses HTTP 200.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Retry-After": { "description": "Present with INDEX_NOT_READY; value 5 seconds. Not guaranteed for other failures.", "schema": { "type": "string", "const": "5" } } } } } } }, "/official": { "get": { "operationId": "getOfficialToken", "summary": "Resolve verified official Rearctor identity", "description": "Identity uses reciprocal configured treasury/factory bindings and the first canonical launch, never just a token name. Returns verified+launch or upcoming/unavailable+message.", "tags": [ "Discovery" ], "parameters": [], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OfficialEnvelope" }, "examples": { "illustrativeDemo": { "summary": "Illustrative saved demo data, not live blockchain activity", "description": "Synthetic example based on the versioned demo fixture. Timestamps and readiness are not current service facts.", "value": { "state": "upcoming", "message": "The official Rearc token has not been launched and verified yet.", "status": { "mode": "demo", "state": "ready", "chainId": 5042, "factory": null, "treasuryAddress": null, "indexedBlock": null, "headBlock": null, "updatedAt": 1789560000000, "error": null } } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "414": { "$ref": "#/components/responses/URITooLong" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/Unavailable" } } }, "head": { "operationId": "getOfficialTokenHead", "summary": "Resolve verified official Rearctor identity (headers only)", "description": "Same lookup, validation and status code as GET, without a response body. Content-Length describes the corresponding GET JSON body.", "tags": [ "Discovery" ], "parameters": [], "responses": { "200": { "description": "Indexed snapshot. Inspect status.mode, state and timestamp before use.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "400": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "404": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "405": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } } }, "414": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } } }, "429": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope.", "headers": {} }, "503": { "description": "No snapshot yet, history unavailable, or an indexed-data read failed. A stale readable snapshot instead uses HTTP 200.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Retry-After": { "description": "Present with INDEX_NOT_READY; value 5 seconds. Not guaranteed for other failures.", "schema": { "type": "string", "const": "5" } } } } } } }, "/protocol-fees": { "get": { "summary": "Paginated protocol fee sources", "description": "Exact indexed accrued and claimed counters by vault. Literal token search and pending-only filtering span the entire catalogue. Does not collect on-chain or include unrealized V4 fees.", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200, "default": "" }, "description": "Trimmed literal substring match over name, symbol, token address and canonical pool address. ASCII case-insensitive; %, _ and backslash are literal. Embedded control characters are rejected." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "maximum": 1000000000 }, "description": "Offset pagination. Pages can shift between independent snapshot reads." }, { "name": "pending", "in": "query", "schema": { "type": "string", "enum": [ "yes", "no" ], "default": "yes" } } ], "responses": { "200": { "description": "Selected page of fee sources", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProtocolFeePage" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "503": { "$ref": "#/components/responses/Unavailable" } } } } }, "components": { "schemas": { "UnsignedDecimal": { "type": "string", "description": "Unsigned base-unit quantity, counter, block height or chain timestamp. Parse as BigInt; do not coerce to a JavaScript Number.", "pattern": "^(0|[1-9][0-9]*)$" }, "Address": { "type": "string", "description": "EVM address. All-zero addresses may appear in explicitly labeled demo data or unbound fields.", "pattern": "^0x[0-9a-fA-F]{40}$" }, "Hash": { "type": "string", "description": "32-byte EVM hash; sample records omit fabricated transaction hashes.", "pattern": "^0x[0-9a-fA-F]{64}$" }, "Status": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "demo", "live" ] }, "state": { "type": "string", "enum": [ "ready", "syncing", "error", "starting", "stale", "initializing" ] }, "chainId": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "factory": { "anyOf": [ { "$ref": "#/components/schemas/Address" }, { "type": "null" } ] }, "treasuryAddress": { "anyOf": [ { "$ref": "#/components/schemas/Address" }, { "type": "null" } ] }, "indexedBlock": { "anyOf": [ { "$ref": "#/components/schemas/UnsignedDecimal" }, { "type": "null" } ] }, "headBlock": { "anyOf": [ { "$ref": "#/components/schemas/UnsignedDecimal" }, { "type": "null" } ] }, "updatedAt": { "anyOf": [ { "type": "integer", "minimum": 0, "description": "Last committed snapshot, Unix milliseconds." }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string", "description": "Sanitized availability message." }, { "type": "null" } ] } }, "required": [ "mode", "state", "chainId", "factory", "treasuryAddress", "indexedBlock", "headBlock", "updatedAt", "error" ], "additionalProperties": false }, "FeeConfig": { "type": "object", "properties": { "buyBps": { "type": "integer", "minimum": 100, "description": "Immutable buy rate: 100 basis points = 1%.", "maximum": 1000 }, "sellBps": { "type": "integer", "minimum": 100, "description": "Immutable sell rate.", "maximum": 1000 }, "creatorBps": { "type": "integer", "minimum": 0, "description": "Share of the distributable 70%, in basis points.", "maximum": 10000 }, "buybackBps": { "type": "integer", "minimum": 0, "description": "Share of the distributable 70%, in basis points.", "maximum": 10000 }, "liquidityBps": { "type": "integer", "minimum": 0, "description": "Share of the distributable 70%, in basis points.", "maximum": 10000 }, "creatorWallet": { "$ref": "#/components/schemas/Address" } }, "required": [ "buyBps", "sellBps", "creatorBps", "buybackBps", "liquidityBps", "creatorWallet" ], "additionalProperties": false, "description": "Protocol share is fixed at 30%. Creator, buyback and liquidity shares sum to 10,000 basis points of the remaining 70%." }, "Launch": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 0, "description": "Zero-based launch ID.", "maximum": 9007199254740991 }, "token": { "$ref": "#/components/schemas/Address" }, "pool": { "$ref": "#/components/schemas/Address" }, "vault": { "$ref": "#/components/schemas/Address" }, "creator": { "$ref": "#/components/schemas/Address" }, "quote": { "$ref": "#/components/schemas/Address" }, "createdAt": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Token creation timestamp, Unix seconds as a decimal string." }, "name": { "type": "string", "description": "Creator-supplied metadata; treat as untrusted content." }, "symbol": { "type": "string", "description": "Creator-supplied metadata; treat as untrusted content." }, "description": { "type": "string", "description": "Creator-supplied metadata; treat as untrusted content." }, "image": { "type": "string", "description": "Creator-supplied metadata; treat as untrusted content." }, "website": { "type": "string", "description": "Creator-supplied metadata; treat as untrusted content." }, "socialX": { "type": "string", "description": "Creator-supplied metadata; treat as untrusted content." }, "telegram": { "type": "string", "description": "Creator-supplied metadata; treat as untrusted content." }, "tokens": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Curve token reserve before graduation; recorded migrated token amount afterward. 18 decimals." }, "reserve": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Curve USDC reserve before graduation; recorded migrated USDC amount afterward. 6 decimals." }, "virtualTokens": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Virtual curve token reserve, 18 decimals." }, "virtualReserve": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Virtual curve USDC reserve, 6 decimals." }, "volume": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Canonical launch-pool volume counter in USDC base units; does not include every external-router V4 swap." }, "supply": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Current token total supply, 18 decimals." }, "threshold": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Graduation threshold in USDC base units." }, "price": { "type": "number", "exclusiveMinimum": 0, "description": "Approximate displayed USDC per token; not an executable quote." }, "graduated": { "type": "boolean" }, "fees": { "$ref": "#/components/schemas/FeeConfig" } }, "required": [ "id", "token", "pool", "vault", "creator", "quote", "createdAt", "name", "symbol", "description", "image", "website", "socialX", "telegram", "tokens", "reserve", "virtualTokens", "virtualReserve", "volume", "supply", "threshold", "price", "graduated", "fees" ], "additionalProperties": false }, "Metric": { "type": "object", "properties": { "spent": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Cumulative project-buyback USDC spent (6 decimals)." }, "burned": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Cumulative project tokens burned by vault buybacks (18 decimals)." }, "executions": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Successful vault-buyback execution count." }, "quoteBudget": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Available project-buyback USDC budget (6 decimals)." }, "tokenBudget": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Available project-buyback token budget (18 decimals)." }, "supply": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Current token total supply (18 decimals)." }, "protocolQuoteAccrued": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Protocol share allocated in USDC units (6 decimals)." }, "protocolQuoteClaimed": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Protocol share paid by the vault in USDC units (6 decimals)." }, "protocolTokenAccrued": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Protocol share allocated in this token (18 decimals)." }, "protocolTokenClaimed": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Protocol share paid by the vault in this token (18 decimals)." }, "liquidityTokenBudget": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Available liquidity-reinvestment token budget (18 decimals)." }, "liquidityQuoteBudget": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Available liquidity-reinvestment USDC budget (6 decimals)." } }, "required": [ "spent", "burned", "executions", "quoteBudget", "tokenBudget", "supply", "protocolQuoteAccrued", "protocolQuoteClaimed", "protocolTokenAccrued", "protocolTokenClaimed", "liquidityTokenBudget", "liquidityQuoteBudget" ], "additionalProperties": false }, "AnalyticsRow": { "type": "object", "properties": { "launch": { "$ref": "#/components/schemas/Launch" }, "spent": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Cumulative project-buyback USDC spent (6 decimals)." }, "burned": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Cumulative project tokens burned by vault buybacks (18 decimals)." }, "executions": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Successful vault-buyback execution count." }, "quoteBudget": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Available project-buyback USDC budget (6 decimals)." }, "tokenBudget": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Available project-buyback token budget (18 decimals)." }, "supply": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Current token total supply (18 decimals)." }, "protocolQuoteAccrued": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Protocol share allocated in USDC units (6 decimals)." }, "protocolQuoteClaimed": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Protocol share paid by the vault in USDC units (6 decimals)." }, "protocolTokenAccrued": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Protocol share allocated in this token (18 decimals)." }, "protocolTokenClaimed": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Protocol share paid by the vault in this token (18 decimals)." }, "liquidityTokenBudget": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Available liquidity-reinvestment token budget (18 decimals)." }, "liquidityQuoteBudget": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Available liquidity-reinvestment USDC budget (6 decimals)." } }, "required": [ "launch", "spent", "burned", "executions", "quoteBudget", "tokenBudget", "supply", "protocolQuoteAccrued", "protocolQuoteClaimed", "protocolTokenAccrued", "protocolTokenClaimed", "liquidityTokenBudget", "liquidityQuoteBudget" ], "additionalProperties": false }, "Config": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 0 }, "quote": { "$ref": "#/components/schemas/Address" }, "minimumSeed": { "$ref": "#/components/schemas/UnsignedDecimal" }, "threshold": { "$ref": "#/components/schemas/UnsignedDecimal" }, "owner": { "$ref": "#/components/schemas/Address" } }, "required": [], "additionalProperties": false, "description": "Only fields available in the current snapshot are present. Early deployment backfill can contain only count." }, "Summary": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 0, "description": "All indexed launches, independent of the query." }, "volume": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Sum of canonical pool USDC volume counters." }, "approaching": { "type": "integer", "minimum": 0, "description": "Ungraduated launches whose reserve is at least 75% of the threshold." }, "graduated": { "type": "integer", "minimum": 0 } }, "required": [ "count", "volume", "approaching", "graduated" ], "additionalProperties": false }, "Catalogue": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Launch" }, "maxItems": 100 }, "total": { "type": "integer", "minimum": 0, "description": "Matches before pagination." }, "status": { "$ref": "#/components/schemas/Status" }, "config": { "$ref": "#/components/schemas/Config" }, "summary": { "$ref": "#/components/schemas/Summary" }, "officialUpcoming": { "type": "boolean", "description": "Separate pending-official-token indicator; it adds no synthetic catalogue row." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "offset": { "type": "integer", "minimum": 0, "maximum": 1000000000 } }, "required": [ "items", "total", "status", "config", "summary", "officialUpcoming", "limit", "offset" ], "additionalProperties": false }, "TokenDetail": { "type": "object", "properties": { "launch": { "$ref": "#/components/schemas/Launch" }, "metric": { "anyOf": [ { "$ref": "#/components/schemas/Metric" }, { "type": "null" } ] }, "status": { "$ref": "#/components/schemas/Status" }, "graduationTransfer": { "anyOf": [ { "$ref": "#/components/schemas/GraduationTransfer" }, { "type": "null" } ], "description": "Always present. Null when no confirmed manual-graduation remainder transfer is indexed, including preview records." } }, "required": [ "launch", "metric", "status", "graduationTransfer" ], "additionalProperties": false }, "Execution": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique event identity; sample IDs are synthetic and labeled." }, "blockNumber": { "$ref": "#/components/schemas/UnsignedDecimal" }, "logIndex": { "type": "integer", "minimum": 0 }, "timestamp": { "type": "integer", "minimum": 0, "description": "Unix seconds." }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "side": { "type": "string", "enum": [ "buy", "sell" ] }, "source": { "type": "string", "enum": [ "curve", "v4" ] }, "actor": { "$ref": "#/components/schemas/Address" }, "actorKind": { "type": "string", "description": "V4 pool-caller can be a router, not the end-user wallet.", "enum": [ "participant", "pool-caller", "sample" ] }, "quoteAmount": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "USDC input on a buy or USDC output on a sell (6 decimals)." }, "tokenAmount": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Executed token amount (18 decimals)." }, "price": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "id", "blockNumber", "logIndex", "timestamp", "side", "source", "actorKind", "quoteAmount", "tokenAmount", "price" ], "additionalProperties": false }, "History": { "type": "object", "properties": { "pool": { "$ref": "#/components/schemas/Address" }, "sample": { "type": "boolean" }, "fromBlock": { "$ref": "#/components/schemas/UnsignedDecimal" }, "toBlock": { "$ref": "#/components/schemas/UnsignedDecimal" }, "snapshotHash": { "$ref": "#/components/schemas/Hash" }, "fromTimestamp": { "type": "integer", "minimum": 0, "description": "Unix seconds; first returned execution when truncated." }, "snapshotTimestamp": { "type": "integer", "minimum": 0, "description": "Unix seconds." }, "fetchedAt": { "type": "integer", "minimum": 0, "description": "Snapshot publication time, Unix milliseconds." }, "omittedZeroAmountSwaps": { "type": "integer", "minimum": 0, "description": "All indexed zero-amount V4 swaps omitted from priced execution history." }, "executions": { "type": "array", "items": { "$ref": "#/components/schemas/Execution" }, "maxItems": 5000 }, "totalExecutions": { "type": "integer", "minimum": 0, "description": "Full indexed priced-execution count." }, "truncated": { "type": "boolean" } }, "required": [ "pool", "sample", "fromBlock", "toBlock", "fromTimestamp", "snapshotTimestamp", "fetchedAt", "omittedZeroAmountSwaps", "executions", "totalExecutions", "truncated" ], "additionalProperties": false }, "HistoryEnvelope": { "type": "object", "properties": { "history": { "$ref": "#/components/schemas/History" }, "status": { "$ref": "#/components/schemas/Status" } }, "required": [ "history", "status" ], "additionalProperties": false }, "Burn": { "type": "object", "properties": { "id": { "type": "string" }, "timestamp": { "type": "integer", "minimum": 0, "description": "Unix seconds." }, "spent": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "USDC used by this buyback (6 decimals)." }, "burned": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Token units burned (18 decimals)." }, "hash": { "$ref": "#/components/schemas/Hash" }, "block": { "$ref": "#/components/schemas/UnsignedDecimal" }, "index": { "type": "integer", "minimum": 0 }, "launch": { "$ref": "#/components/schemas/Launch" } }, "required": [ "id", "timestamp", "spent", "burned", "block", "index" ], "additionalProperties": false, "description": "Project endpoints include launch; treasury burns omit it. Explicit sample records omit transaction hash." }, "BurnPage": { "type": "object", "properties": { "burns": { "type": "array", "items": { "$ref": "#/components/schemas/Burn" }, "maxItems": 500 }, "total": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "offset": { "type": "integer", "minimum": 0, "maximum": 1000000000 }, "truncated": { "type": "boolean", "description": "More events remain after this page." }, "status": { "$ref": "#/components/schemas/Status" } }, "required": [ "burns", "total", "limit", "offset", "truncated", "status" ], "additionalProperties": false }, "HolderConcentration": { "type": "object", "properties": { "holders": { "type": "integer", "minimum": 0, "description": "Positive-balance addresses excluding pool, vault, V4 manager and fixed dead address." }, "top": { "type": "array", "maxItems": 5, "items": { "type": "array", "prefixItems": [ { "$ref": "#/components/schemas/Address" }, { "$ref": "#/components/schemas/UnsignedDecimal" } ], "items": false, "minItems": 2, "maxItems": 2 }, "description": "Largest balances first, ties resolved by address." }, "topFive": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Sum of returned leading balances." }, "creator": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Creator address token balance; may also appear in top." }, "feeWallet": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Creator fee-wallet token balance; may also appear in top." }, "supply": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Full current ERC-20 total supply, including infrastructure and dead-address balances." }, "blockNumber": { "$ref": "#/components/schemas/UnsignedDecimal" } }, "required": [ "holders", "top", "topFive", "creator", "feeWallet", "supply", "blockNumber" ], "additionalProperties": false }, "HoldersEnvelope": { "type": "object", "properties": { "concentration": { "anyOf": [ { "$ref": "#/components/schemas/HolderConcentration" }, { "type": "null" } ] }, "status": { "$ref": "#/components/schemas/Status" } }, "required": [ "concentration", "status" ], "additionalProperties": false }, "AnalyticsScope": { "type": "object", "properties": { "returned": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0, "description": "Full catalogue count." }, "metricsTotal": { "type": "integer", "minimum": 0, "description": "Stored metric row count." }, "truncated": { "type": "boolean", "description": "Returned rows are fewer than stored metric rows." }, "complete": { "type": "boolean", "description": "Returned rows cover the full catalogue." } }, "required": [ "returned", "total", "metricsTotal", "truncated", "complete" ], "additionalProperties": false }, "BurnScope": { "type": "object", "properties": { "returned": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "truncated": { "type": "boolean" } }, "required": [ "returned", "total", "truncated" ], "additionalProperties": false }, "Analytics": { "type": "object", "properties": { "rows": { "type": "array", "items": { "$ref": "#/components/schemas/AnalyticsRow" }, "maxItems": 10000 }, "burns": { "type": "array", "items": { "$ref": "#/components/schemas/Burn" }, "maxItems": 100 }, "total": { "type": "integer", "minimum": 0, "description": "Full catalogue count." }, "status": { "$ref": "#/components/schemas/Status" }, "truncated": { "type": "boolean", "description": "Returned metric rows are fewer than catalogue launches." }, "scope": { "$ref": "#/components/schemas/AnalyticsScope" }, "burnScope": { "$ref": "#/components/schemas/BurnScope" } }, "required": [ "rows", "burns", "total", "status", "truncated", "scope", "burnScope" ], "additionalProperties": false }, "TreasurySnapshot": { "type": "object", "properties": { "owner": { "$ref": "#/components/schemas/Address" }, "pool": { "$ref": "#/components/schemas/Address" }, "token": { "$ref": "#/components/schemas/Address" }, "available": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Available recorded protocol USDC (6 decimals)." }, "received": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Cumulative protocol USDC receipts (6 decimals)." }, "converted": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Cumulative USDC received from protocol-token conversions (6 decimals)." }, "spent": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Cumulative USDC spent on Rearctor buybacks (6 decimals)." }, "burned": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Cumulative Rearctor tokens burned by the treasury (18 decimals)." }, "executions": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Successful protocol-buyback execution count." }, "operations": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Cumulative USDC withdrawn for operations (6 decimals)." }, "block": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Confirmed snapshot block." } }, "required": [ "owner", "pool", "token", "available", "received", "converted", "spent", "burned", "executions", "operations", "block" ], "additionalProperties": false }, "TreasuryEnvelope": { "type": "object", "properties": { "snapshot": { "anyOf": [ { "$ref": "#/components/schemas/TreasurySnapshot" }, { "type": "null" } ] }, "burns": { "type": "array", "items": { "$ref": "#/components/schemas/Burn" }, "maxItems": 500 }, "total": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "offset": { "type": "integer", "minimum": 0, "maximum": 1000000000 }, "truncated": { "type": "boolean", "description": "More events remain after this page." }, "status": { "$ref": "#/components/schemas/Status" } }, "required": [ "snapshot", "burns", "total", "limit", "offset", "truncated", "status" ], "additionalProperties": false }, "OfficialVerified": { "type": "object", "properties": { "state": { "type": "string", "const": "verified" }, "launch": { "$ref": "#/components/schemas/Launch" }, "status": { "$ref": "#/components/schemas/Status" } }, "required": [ "state", "launch", "status" ], "additionalProperties": false }, "OfficialPending": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "upcoming", "unavailable" ] }, "message": { "type": "string" }, "status": { "$ref": "#/components/schemas/Status" } }, "required": [ "state", "message", "status" ], "additionalProperties": false }, "OfficialEnvelope": { "oneOf": [ { "$ref": "#/components/schemas/OfficialVerified" }, { "$ref": "#/components/schemas/OfficialPending" } ] }, "Health": { "type": "object", "properties": { "ok": { "type": "boolean", "description": "A saved snapshot is readable; not a freshness guarantee." }, "ready": { "type": "boolean" }, "status": { "$ref": "#/components/schemas/Status" } }, "required": [ "ok", "ready", "status" ], "additionalProperties": false }, "Error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "INVALID_REQUEST", "NOT_FOUND", "TOKEN_NOT_FOUND", "METHOD_NOT_ALLOWED", "URI_TOO_LONG", "INDEX_NOT_READY", "HISTORY_UNAVAILABLE", "INDEX_UNAVAILABLE" ] }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false }, "ErrorEnvelope": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/Error" }, "status": { "$ref": "#/components/schemas/Status" } }, "required": [ "error" ], "additionalProperties": false }, "GraduationTransfer": { "type": "object", "description": "Confirmed accounted-token remainder sent to the fixed dead address during manual graduation. Separate from buyback burns and market executions; does not reduce ERC-20 total supply.", "properties": { "recipient": { "$ref": "#/components/schemas/Address", "description": "Fixed DEAD_ADDRESS: 0x000000000000000000000000000000000000dEaD." }, "amount": { "$ref": "#/components/schemas/UnsignedDecimal", "description": "Accounted tokens transferred during this migration, in 18-decimal base units; not the recipient’s entire balance." }, "transactionHash": { "$ref": "#/components/schemas/Hash" }, "blockNumber": { "$ref": "#/components/schemas/UnsignedDecimal" }, "logIndex": { "type": "integer", "minimum": 0 }, "timestamp": { "type": "integer", "minimum": 0, "description": "Block time in Unix seconds." }, "totalSupplyReduced": { "type": "boolean", "const": false } }, "required": [ "recipient", "amount", "transactionHash", "blockNumber", "logIndex", "timestamp", "totalSupplyReduced" ], "additionalProperties": false }, "ProtocolFeePage": { "type": "object", "required": [ "rows", "total", "limit", "offset", "status" ], "properties": { "rows": { "type": "array", "maxItems": 50, "items": { "type": "object", "required": [ "launch", "protocolQuoteAccrued", "protocolQuoteClaimed", "protocolTokenAccrued", "protocolTokenClaimed" ], "properties": { "launch": { "$ref": "#/components/schemas/Launch" }, "protocolQuoteAccrued": { "$ref": "#/components/schemas/UnsignedDecimal" }, "protocolQuoteClaimed": { "$ref": "#/components/schemas/UnsignedDecimal" }, "protocolTokenAccrued": { "$ref": "#/components/schemas/UnsignedDecimal" }, "protocolTokenClaimed": { "$ref": "#/components/schemas/UnsignedDecimal" } } } }, "total": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 1, "maximum": 50 }, "offset": { "type": "integer", "minimum": 0 }, "status": { "$ref": "#/components/schemas/Status" } } } }, "responses": { "BadRequest": { "description": "Invalid or unsupported query/identifier, including duplicate parameters.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "NotFound": { "description": "Unknown route or token absent from this snapshot.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "MethodNotAllowed": { "description": "The backend accepts GET and HEAD only; the public proxy separately answers OPTIONS preflight.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "URITooLong": { "description": "Request URL exceeds 4,096 characters at the application boundary.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "Unavailable": { "description": "No snapshot yet, history unavailable, or an indexed-data read failed. A stale readable snapshot instead uses HTTP 200.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Retry-After": { "description": "Present with INDEX_NOT_READY; value 5 seconds. Not guaranteed for other failures.", "schema": { "type": "string", "const": "5" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "RateLimited": { "description": "Public proxy request limit exceeded. This response need not be JSON or use the application error envelope." } } } }