{ "openapi": "3.1.0", "info": { "title": "ZecBlock API v1", "version": "1.0.0-preview", "summary": "Versioned, contract-stable read/write API for the Zcash blockchain data and privacy-intelligence features exposed by ZecBlock.", "description": "This is the v1 contract layer. It is gated behind API_V1_ENABLED and, pre-launch, an X-API-Preview-Key header (see the previewKey security scheme) — see server/api/v1/README.md in the repository for exact mount instructions and current caveats. Every success response uses the {data, meta} envelope; every error response is an RFC 9457 problem+json document. Every public inventory entry is adapted; The manifest explicitly identifies retained operational routes and payment-protected services.", "contact": { "name": "ZecBlock / Atmosphere Labs" } }, "servers": [ { "url": "https://api.zecblock.com", "description": "Mainnet API host." }, { "url": "https://api.testnet.zecblock.com", "description": "Testnet API host." }, { "url": "http://127.0.0.1:3002", "description": "Private read-only development preview." } ], "tags": [ { "name": "address" }, { "name": "analytics" }, { "name": "ask" }, { "name": "blocks" }, { "name": "crosschain" }, { "name": "crosslink" }, { "name": "mempool" }, { "name": "migration" }, { "name": "mining" }, { "name": "names" }, { "name": "network" }, { "name": "privacy" }, { "name": "pulse" }, { "name": "reorgs" }, { "name": "scan" }, { "name": "search" }, { "name": "shielded-pools" }, { "name": "signals" }, { "name": "sitemaps" }, { "name": "stats" }, { "name": "system" }, { "name": "transactions" }, { "name": "transparent" }, { "name": "valuation" } ], "security": [ { "previewKey": [] } ], "components": { "securitySchemes": { "previewKey": { "type": "apiKey", "in": "header", "name": "X-API-Preview-Key", "description": "Required while API_V1_LAUNCHED=false. Dropped once v1 is generally available." } }, "schemas": { "Problem": { "type": "object", "description": "RFC 9457 problem+json error body.", "required": [ "type", "title", "status" ], "properties": { "type": { "type": "string", "format": "uri", "description": "A URI identifying the problem category." }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "instance": { "type": "string" }, "errors": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "issue": { "type": "string" } } } } } }, "Meta": { "type": "object", "required": [ "requestId", "network", "generatedAt", "indexedHeight", "source", "cache", "freshness", "units" ], "properties": { "requestId": { "type": "string", "format": "uuid" }, "network": { "type": "string", "enum": [ "mainnet", "testnet", "crosslink-testnet" ] }, "generatedAt": { "type": "string", "format": "date-time" }, "indexedHeight": { "type": [ "integer", "null" ] }, "source": { "type": "object", "required": [ "indexedHeight", "observedAt" ], "properties": { "indexedHeight": { "type": [ "integer", "null" ] }, "observedAt": { "type": [ "string", "null" ], "format": "date-time" } } }, "cache": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "hit", "miss", "stale", "unknown" ] }, "ageSeconds": { "type": [ "number", "null" ] } } }, "dataAgeSeconds": { "type": "number" }, "freshness": { "type": "object", "required": [ "status", "ageSeconds" ], "properties": { "status": { "type": "string", "enum": [ "fresh", "stale", "unknown", "unavailable" ] }, "ageSeconds": { "type": [ "number", "null" ] } } }, "units": { "type": "object", "required": [ "authoritativeMonetary", "authoritativeEncoding", "zatoshiPerZec", "legacyFormattedFields" ], "properties": { "authoritativeMonetary": { "const": "zatoshi" }, "authoritativeEncoding": { "const": "decimal-string" }, "zatoshiPerZec": { "const": "100000000" }, "legacyFormattedFields": { "const": "field-defined" } } }, "warnings": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "issue": { "type": "string" } } } }, "page": { "type": "object", "description": "Present on cursor-paginated list endpoints.", "properties": { "limit": { "type": "integer" }, "hasNext": { "type": "boolean" }, "hasPrev": { "type": "boolean" }, "nextCursor": { "type": [ "string", "null" ] }, "prevCursor": { "type": [ "string", "null" ] }, "total": { "type": [ "integer", "null" ] } } } } }, "ZatoshiString": { "type": "string", "pattern": "^-?[0-9]+$", "description": "Integer amount in zatoshis (1 ZEC = 100,000,000 zatoshis), encoded as a decimal string to avoid float precision loss. Never a JSON number." } } }, "paths": { "/v1/network/accounting/history": { "get": { "operationId": "get_network_Accounting_History", "summary": "Canonical block fee allocations, shielded activity and sampled NSM/supply history.", "tags": [ "network" ], "parameters": [ { "name": "before", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 499999999, "description": "Exclusive canonical block-height cursor." }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 120 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/network/accounting/history", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Canonical block fee allocations, shielded activity and sampled NSM/supply history.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/ask/chat": { "post": { "operationId": "post_ask_Chat", "summary": "Contextual mainnet questions with reviewed public sources, supported language selection and bounded recent questions. Paid answers require bot verification and shared spend limits.", "tags": [ "ask" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "question": { "type": "string", "minLength": 1, "maxLength": 1000 }, "page": { "type": "string", "enum": [ "home", "ask", "transactions", "blocks", "pools", "ironwood", "crosschain", "pulse", "miner_zodl", "network", "addresses", "mempool", "nodes", "mining", "reorgs", "charts", "turnstile", "privacy_risks", "wallet_signals", "valuation", "usage_clock", "governance", "tools", "decode", "broadcast", "decrypt", "blend_check", "unit_converter", "anchor_search", "docs", "learn", "newsletter", "about", "press", "attestations", "privacy_policy", "terms", "privacy", "chart_pool_balances", "chart_supply", "chart_shielded_supply", "chart_turnstile", "chart_pool_share", "chart_search_interest", "chart_daily_activity", "chart_privacy_adoption", "chart_privacy_score", "chart_flow_volume", "chart_net_flow", "chart_flow_thresholds", "chart_flow_buckets", "chart_network_hashrate", "chart_mining_distribution", "chart_miner_rewards", "chart_block_time", "chart_difficulty", "chart_block_fees", "chart_tx_per_block", "chart_fees", "chart_node_storage", "chart_protocol_commitments", "chart_protocol_nullifiers", "chart_price_vs_realized", "chart_mvrv", "chart_nupl", "chart_sopr", "chart_realized_cap", "chart_dormancy", "chart_coin_days", "chart_hodl_waves", "chart_swap_volume", "chart_swap_count", "transaction", "block", "address", "name", "explorer" ] }, "context": { "anyOf": [ { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "metric": { "type": "string", "enum": [ "balances", "flows", "activity", "swap_volume", "swap_count", "transactions", "pulse", "migration_share", "chain_inflows", "chain_outflows" ] }, "period": { "type": "string", "enum": [ "30d", "90d", "1y" ] }, "pool": { "type": "string", "enum": [ "all", "orchard", "ironwood", "sapling" ] }, "view": { "type": "string", "enum": [ "line", "bar", "table" ] }, "start": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "end": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] } }, "required": [ "version", "metric", "period", "pool", "view", "start", "end" ], "additionalProperties": false }, { "type": "null" } ] }, "transaction": { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" }, "block": { "type": "string", "pattern": "^(?:0|[1-9]\\d{0,8}|[a-fA-F0-9]{64})$" }, "locale": { "default": "auto", "type": "string", "enum": [ "auto", "en", "fr", "es", "de", "pt", "ja", "zh", "ko", "ar", "ru" ] }, "history": { "default": [], "maxItems": 4, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "challenge": { "type": "string", "maxLength": 2048 } }, "required": [ "question", "page", "context", "locale", "history" ], "additionalProperties": false } } } }, "x-cipherscan-legacy-path": null, "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "native", "responses": { "200": { "description": "Contextual mainnet questions with reviewed public sources, supported language selection and bounded recent questions. Paid answers require bot verification and shared spend limits.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Per-IP, shared daily or concurrent request limit reached.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "AI not configured, shared limiter unavailable, or provider failure. Guided analyses remain available.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/ask/explain": { "post": { "operationId": "post_ask_Explain", "summary": "Explain a mainnet analysis using server-fetched public evidence. Requires configured AI and an exact fingerprint match with the chart observations. Private, no-store.", "tags": [ "ask" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "spec": { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "metric": { "type": "string", "enum": [ "balances", "flows", "activity", "swap_volume", "swap_count", "transactions", "pulse", "migration_share", "chain_inflows", "chain_outflows" ] }, "period": { "type": "string", "enum": [ "30d", "90d", "1y" ] }, "pool": { "type": "string", "enum": [ "all", "orchard", "ironwood", "sapling" ] }, "view": { "type": "string", "enum": [ "line", "bar", "table" ] }, "start": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "end": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] } }, "required": [ "version", "metric", "period", "pool", "view", "start", "end" ], "additionalProperties": false }, "evidenceKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "challenge": { "type": "string", "maxLength": 2048 } }, "required": [ "spec", "evidenceKey" ], "additionalProperties": false } } } }, "x-cipherscan-legacy-path": null, "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "native", "responses": { "200": { "description": "Explain a mainnet analysis using server-fetched public evidence. Requires configured AI and an exact fingerprint match with the chart observations. Private, no-store.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Per-IP, shared daily or concurrent request limit reached.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "AI not configured, shared limiter unavailable, or provider failure. Guided analyses remain available.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/ask": { "get": { "operationId": "get_ask", "summary": "Mainnet Ask capability: guided starter analyses or configured AI interpretation. Private, no-store.", "tags": [ "ask" ], "x-cipherscan-legacy-path": null, "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "native", "responses": { "200": { "description": "Mainnet Ask capability: guided starter analyses or configured AI interpretation. Private, no-store.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Per-IP, shared daily or concurrent request limit reached.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "AI not configured, shared limiter unavailable, or provider failure. Guided analyses remain available.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } }, "post": { "operationId": "post_ask", "summary": "Select a validated mainnet pool, swap, transaction-activity or Pulse analysis from a question and current context. Returns a specification, never invented observations. Free-form AI requires configured provider and shared usage limits.", "tags": [ "ask" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "question": { "type": "string", "minLength": 1, "maxLength": 1000 }, "context": { "anyOf": [ { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "metric": { "type": "string", "enum": [ "balances", "flows", "activity", "swap_volume", "swap_count", "transactions", "pulse", "migration_share", "chain_inflows", "chain_outflows" ] }, "period": { "type": "string", "enum": [ "30d", "90d", "1y" ] }, "pool": { "type": "string", "enum": [ "all", "orchard", "ironwood", "sapling" ] }, "view": { "type": "string", "enum": [ "line", "bar", "table" ] }, "start": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "end": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] } }, "required": [ "version", "metric", "period", "pool", "view", "start", "end" ], "additionalProperties": false }, { "type": "null" } ] }, "challenge": { "type": "string", "maxLength": 2048 } }, "required": [ "question", "context" ], "additionalProperties": false } } } }, "x-cipherscan-legacy-path": null, "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "native", "responses": { "200": { "description": "Select a validated mainnet pool, swap, transaction-activity or Pulse analysis from a question and current context. Returns a specification, never invented observations. Free-form AI requires configured provider and shared usage limits.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Per-IP, shared daily or concurrent request limit reached.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "AI not configured, shared limiter unavailable, or provider failure. Guided analyses remain available.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/attestations": { "get": { "operationId": "get_network_Attestations", "summary": "Curated Zero Indexer endpoints with periodic enclave, TLS binding and release observations. Per-observation freshness and release status remain separate.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/attestations", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Curated Zero Indexer endpoints with periodic enclave, TLS binding and release observations. Per-observation freshness and release status remain separate.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/attestations/{id}": { "get": { "operationId": "get_network_Attestations_Id", "summary": "One registered Zero Indexer endpoint and its latest observation. Unknown registry IDs return 404.", "tags": [ "network" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/network/attestations/:id", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "One registered Zero Indexer endpoint and its latest observation. Unknown registry IDs return 404.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/names/status": { "get": { "operationId": "get_names_Status", "summary": "Name registry status and pricing.", "tags": [ "names" ], "x-cipherscan-legacy-path": "/api/names/status", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "native", "responses": { "200": { "description": "Name registry status and pricing.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/names": { "get": { "operationId": "get_names", "summary": "Cursor-paginated registered names.", "tags": [ "names" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor from a previous response's meta.page.nextCursor/prevCursor.", "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/names", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "native", "responses": { "200": { "description": "Cursor-paginated registered names.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": {} }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/names/{name}/events": { "get": { "operationId": "get_names_Name_Events", "summary": "Recent public name registry events.", "tags": [ "names" ], "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/name/:name/events", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "native", "responses": { "200": { "description": "Recent public name registry events.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/names/{name}": { "get": { "operationId": "get_names_Name", "summary": "Name registration or pricing when unregistered.", "tags": [ "names" ], "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/name/:name", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "native", "responses": { "200": { "description": "Name registration or pricing when unregistered.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/info": { "get": { "operationId": "get_network_Info", "summary": "Current indexed chain height.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/info", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Current indexed chain height.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/blocks": { "get": { "operationId": "get_blocks", "summary": "Cursor-paginated block list (canonical listing endpoint).", "tags": [ "blocks" ], "parameters": [ { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "description": "Inclusive UTC date, YYYY-MM-DD. Mining software history requires period=custom." }, "description": "Inclusive UTC date, YYYY-MM-DD. Mining software history requires period=custom." }, { "name": "max_fees", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0, "maximum": 21000000, "description": "Inclusive maximum total transaction fees in ZEC (up to 8 decimal places)." }, "description": "Inclusive maximum total transaction fees in ZEC (up to 8 decimal places)." }, { "name": "max_height", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 2147483647, "description": "Inclusive maximum canonical block height." }, "description": "Inclusive maximum canonical block height." }, { "name": "max_interval", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 2147483647, "description": "Inclusive maximum difference from the canonical parent timestamp in seconds." }, "description": "Inclusive maximum difference from the canonical parent timestamp in seconds." }, { "name": "max_size", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 2147483647, "description": "Inclusive maximum indexed block size in bytes." }, "description": "Inclusive maximum indexed block size in bytes." }, { "name": "max_txs", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 2147483647, "description": "Inclusive maximum transaction count including coinbase." }, "description": "Inclusive maximum transaction count including coinbase." }, { "name": "min_fees", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0, "maximum": 21000000, "description": "Inclusive minimum total transaction fees in ZEC (up to 8 decimal places)." }, "description": "Inclusive minimum total transaction fees in ZEC (up to 8 decimal places)." }, { "name": "min_height", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 2147483647, "description": "Inclusive minimum canonical block height." }, "description": "Inclusive minimum canonical block height." }, { "name": "min_interval", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 2147483647, "description": "Inclusive minimum difference from the canonical parent timestamp in seconds." }, "description": "Inclusive minimum difference from the canonical parent timestamp in seconds." }, { "name": "min_size", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 2147483647, "description": "Inclusive minimum indexed block size in bytes." }, "description": "Inclusive minimum indexed block size in bytes." }, { "name": "min_txs", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 2147483647, "description": "Inclusive minimum transaction count including coinbase." }, "description": "Inclusive minimum transaction count including coinbase." }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "newest", "oldest", "interval_asc", "interval_desc", "size_asc", "size_desc", "fees_asc", "fees_desc", "txs_asc", "txs_desc" ], "default": "newest", "description": "Sort the complete filtered dataset by height, parent interval, indexed size, fees or transaction count. Metric ties use height; unavailable values sort last. Cursor remains bound to every filter and order." }, "description": "Sort the complete filtered dataset by height, parent interval, indexed size, fees or transaction count. Metric ties use height; unavailable values sort last. Cursor remains bound to every filter and order." }, { "name": "pool", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "all", "2Miners", "AntPool", "Binance Pool", "F2Pool", "Foundry USA", "Kryptex", "Luxor", "Mining Dutch", "MySoloPool", "NiceHash", "Private Miner B", "Sluicey Pool", "Unidentified #5", "ViaBTC", "ViaBTC-Solo", "ZEC Mining Pool", "unattributed" ], "default": "all", "description": "Mining-pool payout-address attribution, independent of software markers." }, "description": "Mining-pool payout-address attribution, independent of software markers." }, { "name": "software", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "all", "zebra", "zakura", "other", "unknown", "conflicting", "missing" ], "default": "all", "description": "Self-reported coinbase marker; unknown means unmarked, other means zcashd, missing means unavailable coinbase data." }, "description": "Self-reported coinbase marker; unknown means unmarked, other means zcashd, missing means unavailable coinbase data." }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "description": "Inclusive UTC end date, YYYY-MM-DD. Mining software history requires period=custom." }, "description": "Inclusive UTC end date, YYYY-MM-DD. Mining software history requires period=custom." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor from a previous response's meta.page.nextCursor/prevCursor.", "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/blocks/list", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Cursor-paginated block list (canonical listing endpoint).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": {} }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/blocks/{heightOrHash}": { "get": { "operationId": "get_blocks_HeightOrHash", "summary": "Block detail by height or hash.", "tags": [ "blocks" ], "parameters": [ { "name": "heightOrHash", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "summary", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/block/:heightOrHash", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Block detail by height or hash.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/search/anchors/{root}": { "get": { "operationId": "get_search_Anchors_Root", "summary": "Look up the block containing a given Orchard/Sapling anchor root.", "tags": [ "search" ], "parameters": [ { "name": "root", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/search/anchor/:root", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Look up the block containing a given Orchard/Sapling anchor root.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/blocks/{hashOrHeight}/archive": { "get": { "operationId": "get_blocks_HashOrHeight_Archive", "summary": "Orphaned/non-canonical block archive lookup.", "tags": [ "blocks" ], "parameters": [ { "name": "hashOrHeight", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/block-archive/:hashOrHeight", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Orphaned/non-canonical block archive lookup.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/block-time": { "get": { "operationId": "get_network_Block-time", "summary": "Observed block intervals and rolling averages with node-announced target spacing.", "tags": [ "network" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "6h", "24h", "7d" ], "default": "24h", "description": "Trailing block-header observation window." }, "description": "Trailing block-header observation window." } ], "x-cipherscan-legacy-path": "/api/network/block-time", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Observed block intervals and rolling averages with node-announced target spacing.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/accounting": { "get": { "operationId": "get_network_Accounting", "summary": "Latest canonical block fees, miner receipts and separate authoritative NSM reserve balance.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/accounting", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Latest canonical block fees, miner receipts and separate authoritative NSM reserve balance.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/stats": { "get": { "operationId": "get_network_Stats", "summary": "Aggregate network statistics. Headline hashrate uses canonical target work over the full trailing 24 hours; mining.hashrateEstimate supplies shared 24h/7d windows and as-of timestamps. Unavailable rates are null.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/stats", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Aggregate network statistics. Headline hashrate uses canonical target work over the full trailing 24 hours; mining.hashrateEstimate supplies shared 24h/7d windows and as-of timestamps. Unavailable rates are null.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/fees": { "get": { "operationId": "get_network_Fees", "summary": "Fee estimates.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/fees", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Fee estimates.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/health": { "get": { "operationId": "get_network_Health", "summary": "Zebra node health snapshot.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/health", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Zebra node health snapshot.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/peers": { "get": { "operationId": "get_network_Peers", "summary": "Known peer list.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/peers", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Known peer list.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/supply/transparent-breakdown": { "get": { "operationId": "get_network_Supply_Transparent-breakdown", "summary": "Transparent supply breakdown.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/supply/transparent-breakdown", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Transparent supply breakdown.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/supply": { "get": { "operationId": "get_network_Supply", "summary": "Total/circulating supply.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/supply", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Total/circulating supply.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/blockchain-info": { "get": { "operationId": "get_network_Blockchain-info", "summary": "Zebra getblockchaininfo passthrough summary.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/blockchain-info", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Zebra getblockchaininfo passthrough summary.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/circulating-supply": { "get": { "operationId": "get_network_Circulating-supply", "summary": "Circulating supply, plain-number legacy format.", "tags": [ "network" ], "parameters": [ { "name": "format", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Compatibility parameter; v1 always returns JSON." } ], "x-cipherscan-legacy-path": "/api/circulating-supply", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Circulating supply, plain-number legacy format.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/nodes": { "get": { "operationId": "get_network_Nodes", "summary": "Ziggurat crawler node census.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/nodes", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Ziggurat crawler node census.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/nodes/stats": { "get": { "operationId": "get_network_Nodes_Stats", "summary": "Node census summary stats.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/nodes/stats", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Node census summary stats.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/nodes/history": { "get": { "operationId": "get_network_Nodes_History", "summary": "Historical node count series.", "tags": [ "network" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/network/node-history", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Historical node count series.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/price": { "get": { "operationId": "get_network_Price", "summary": "Current ZEC price.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/price", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Current ZEC price.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/price/at": { "get": { "operationId": "get_network_Price_At", "summary": "Historical ZEC price at a timestamp.", "tags": [ "network" ], "parameters": [ { "name": "date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" }, "description": "UTC calendar date (YYYY-MM-DD). The response indicates when an earlier available price is used." } ], "x-cipherscan-legacy-path": "/api/price/at", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Historical ZEC price at a timestamp.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/protocol-stats": { "get": { "operationId": "get_network_Protocol-stats", "summary": "Protocol version adoption stats.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/protocol-stats", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Protocol version adoption stats.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/topology": { "get": { "operationId": "get_network_Topology", "summary": "Peer topology graph.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/topology", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Peer topology graph.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/nodes/list": { "get": { "operationId": "get_network_Nodes_List", "summary": "Paged node list.", "tags": [ "network" ], "parameters": [ { "name": "dir", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/network/nodes/list", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Paged node list.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/nodes/health-score": { "get": { "operationId": "get_network_Nodes_Health-score", "summary": "Per-node health scoring.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/nodes/health-score", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Per-node health scoring.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/nodes/reliability": { "get": { "operationId": "get_network_Nodes_Reliability", "summary": "Node reliability metrics.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/nodes/reliability", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Node reliability metrics.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/nodes/upgrade-readiness": { "get": { "operationId": "get_network_Nodes_Upgrade-readiness", "summary": "NU upgrade readiness by node.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/nodes/upgrade-readiness", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "NU upgrade readiness by node.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/nodes/concentration": { "get": { "operationId": "get_network_Nodes_Concentration", "summary": "Node/ASN/geography concentration metrics.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/nodes/concentration", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Node/ASN/geography concentration metrics.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/halving": { "get": { "operationId": "get_network_Halving", "summary": "Node-observed halving schedule and cadence-based estimates.", "tags": [ "network" ], "x-cipherscan-legacy-path": "/api/network/halving", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Node-observed halving schedule and cadence-based estimates.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mining/metrics": { "get": { "operationId": "get_mining_Metrics", "summary": "Mining metrics summary.", "tags": [ "mining" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "window", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/network/mining-metrics", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Mining metrics summary.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mining/hashrate-history": { "get": { "operationId": "get_mining_Hashrate-history", "summary": "Work-based hashrate in Sol/s over full trailing 24h or 7d windows, sampled at midnight UTC. Current estimates and as-of times are shared through network/stats. Missing samples return null.", "tags": [ "mining" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "7d", "30d", "90d", "1y", "all" ], "default": "90d", "description": "Range of historical samples ending at UTC midnight." }, "description": "Range of historical samples ending at UTC midnight." }, { "name": "window", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "24h", "7d" ], "default": "24h", "description": "Full trailing work-estimation window. Independent of chart range." }, "description": "Full trailing work-estimation window. Independent of chart range." } ], "x-cipherscan-legacy-path": "/api/network/hashrate-history", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Work-based hashrate in Sol/s over full trailing 24h or 7d windows, sampled at midnight UTC. Current estimates and as-of times are shared through network/stats. Missing samples return null.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/shielded-pools/history": { "get": { "operationId": "get_shielded-pools_History", "summary": "Daily shielded and transparent pool balances from chain state.", "tags": [ "shielded-pools" ], "parameters": [ { "name": "format", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/network/pool-history", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Daily shielded and transparent pool balances from chain state.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/emission": { "get": { "operationId": "get_network_Emission", "summary": "Observed chain supply and estimated daily subsidy.", "tags": [ "network" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/network/emission", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Observed chain supply and estimated daily subsidy.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/chain-size-history": { "get": { "operationId": "get_network_Chain-size-history", "summary": "Chain size growth over time.", "tags": [ "network" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/network/chain-size-history", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Chain size growth over time.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/blocks/recent-summary": { "get": { "operationId": "get_network_Blocks_Recent-summary", "summary": "Lightweight recent-blocks summary. coinbaseTransparentOutput is transparent coinbase outputs in ZEC, including non-miner payouts; minerReward is a deprecated alias and is not actual miner receipts. Missing amounts are null.", "tags": [ "network" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/network/blocks/recent", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Lightweight recent-blocks summary. coinbaseTransparentOutput is transparent coinbase outputs in ZEC, including non-miner payouts; minerReward is a deprecated alias and is not actual miner receipts. Missing amounts are null.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/analytics": { "get": { "operationId": "get_crosschain_Analytics", "summary": "Indexed ZEC swap analytics with explicit coverage, native ZEC volumes, UTC buckets and observed lifecycle counts.", "tags": [ "crosschain" ], "parameters": [ { "name": "granularity", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "hour", "day" ], "description": "Defaults to hour for 24h/7d, day otherwise. Hour is only accepted for 24h/7d." }, "description": "Defaults to hour for 24h/7d, day otherwise. Hour is only accepted for 24h/7d." }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "24h", "7d", "30d", "90d", "1y", "all" ], "default": "30d", "description": "Trailing UTC window; all starts at the earliest indexed record. Coverage can be incomplete." }, "description": "Trailing UTC window; all starts at the earliest indexed record. Coverage can be incomplete." } ], "x-cipherscan-legacy-path": "/api/crosschain/analytics", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Indexed ZEC swap analytics with explicit coverage, native ZEC volumes, UTC buckets and observed lifecycle counts.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/swaps": { "get": { "operationId": "get_crosschain_Swaps", "summary": "Filterable swap records with exact amount strings, both transaction legs and filter-bound pagination.", "tags": [ "crosschain" ], "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[a-z0-9_-]{1,32}$" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 8192, "description": "Opaque data.nextCursor. Bound to filters and the original time window; do not construct or edit." }, "description": "Opaque data.nextCursor. Bound to filters and the original time window; do not construct or edit." }, { "name": "destAsset", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256, "description": "Exact upstream destinationAsset identifier." }, "description": "Exact upstream destinationAsset identifier." }, { "name": "direction", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "inflow", "outflow", "internal" ], "description": "Native ZEC asset acquired, exchanged or ZEC-to-ZEC. Asset direction does not prove an on-chain transfer." }, "description": "Native ZEC asset acquired, exchanged or ZEC-to-ZEC. Asset direction does not prove an on-chain transfer." }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time", "description": "Inclusive UTC ISO timestamp, overrides the period start." }, "description": "Inclusive UTC ISO timestamp, overrides the period start." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "maxUsd", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0, "maximum": 1000000000000, "description": "Inclusive source-side USD maximum (up to 8 decimal places)." }, "description": "Inclusive source-side USD maximum (up to 8 decimal places)." }, { "name": "minUsd", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0, "maximum": 1000000000000, "description": "Inclusive source-side USD minimum (up to 8 decimal places)." }, "description": "Inclusive source-side USD minimum (up to 8 decimal places)." }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "24h", "7d", "30d", "90d", "1y", "all" ], "default": "30d", "description": "Trailing UTC window; all starts at the earliest indexed record. Coverage can be incomplete." }, "description": "Trailing UTC window; all starts at the earliest indexed record. Coverage can be incomplete." }, { "name": "referral", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256, "description": "Exact upstream referral value." }, "description": "Exact upstream referral value." }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200, "description": "Exact deposit, recipient or sender address, or source/destination transaction hash." }, "description": "Exact deposit, recipient or sender address, or source/destination transaction hash." }, { "name": "sourceAsset", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256, "description": "Exact upstream originAsset identifier." }, "description": "Exact upstream originAsset identifier." }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "SUCCESS", "FAILED", "REFUNDED", "PROCESSING", "PENDING_DEPOSIT", "INCOMPLETE_DEPOSIT" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time", "description": "Exclusive UTC ISO timestamp, fixes the end of the window." }, "description": "Exclusive UTC ISO timestamp, fixes the end of the window." }, { "name": "token", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 64 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/crosschain/swaps", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Filterable swap records with exact amount strings, both transaction legs and filter-bound pagination.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/stats": { "get": { "operationId": "get_crosschain_Stats", "summary": "Cross-chain swap stats.", "tags": [ "crosschain" ], "x-cipherscan-legacy-path": "/api/crosschain/stats", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Cross-chain swap stats.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/inflows": { "get": { "operationId": "get_crosschain_Inflows", "summary": "Cross-chain inflow volume.", "tags": [ "crosschain" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/crosschain/inflows", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Cross-chain inflow volume.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/outflows": { "get": { "operationId": "get_crosschain_Outflows", "summary": "Cross-chain outflow volume.", "tags": [ "crosschain" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/crosschain/outflows", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Cross-chain outflow volume.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/status": { "get": { "operationId": "get_crosschain_Status", "summary": "NEAR Intents integration configuration status.", "tags": [ "crosschain" ], "x-cipherscan-legacy-path": "/api/crosschain/status", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "NEAR Intents integration configuration status.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/db-stats": { "get": { "operationId": "get_crosschain_Db-stats", "summary": "Materialized-view-backed swap dashboard stats.", "tags": [ "crosschain" ], "x-cipherscan-legacy-path": "/api/crosschain/db-stats", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Materialized-view-backed swap dashboard stats.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/trends": { "get": { "operationId": "get_crosschain_Trends", "summary": "Cross-chain swap trends over time.", "tags": [ "crosschain" ], "parameters": [ { "name": "granularity", "in": "query", "required": false, "schema": { "default": "daily", "type": "string", "enum": [ "daily", "weekly" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "period", "in": "query", "required": false, "schema": { "default": "30d", "type": "string", "enum": [ "7d", "30d", "90d", "1y", "all" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/crosschain/trends", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Cross-chain swap trends over time.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/history": { "get": { "operationId": "get_crosschain_History", "summary": "Historical swap list.", "tags": [ "crosschain" ], "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "direction", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "inflow", "outflow" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "page", "in": "query", "required": false, "schema": { "default": 1, "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/crosschain/history", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Historical swap list.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/volume-by-chain": { "get": { "operationId": "get_crosschain_Volume-by-chain", "summary": "Swap volume grouped by source chain.", "tags": [ "crosschain" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "default": "30d", "type": "string", "enum": [ "7d", "30d" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/crosschain/volume-by-chain", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Swap volume grouped by source chain.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/addresses/{address}": { "get": { "operationId": "get_crosschain_Addresses_Address", "summary": "Cross-chain swap history for one ZEC address.", "tags": [ "crosschain" ], "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/crosschain/address/:address", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Cross-chain swap history for one ZEC address.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/popular-pairs": { "get": { "operationId": "get_crosschain_Popular-pairs", "summary": "Most popular source/dest chain pairs.", "tags": [ "crosschain" ], "x-cipherscan-legacy-path": "/api/crosschain/popular-pairs", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Most popular source/dest chain pairs.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/size-distribution": { "get": { "operationId": "get_crosschain_Size-distribution", "summary": "Swap size histogram.", "tags": [ "crosschain" ], "x-cipherscan-legacy-path": "/api/crosschain/size-distribution", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Swap size histogram.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosschain/wrapped-zec/supply": { "get": { "operationId": "get_crosschain_Wrapped-zec_Supply", "summary": "Wrapped ZEC supply across chains (read-only RPC, no shared DB).", "tags": [ "crosschain" ], "x-cipherscan-legacy-path": "/api/wrapped-zec/supply", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Wrapped ZEC supply across chains (read-only RPC, no shared DB).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/stats": { "get": { "operationId": "get_privacy_Stats", "summary": "Aggregate shielded-vs-transparent stats.", "tags": [ "privacy" ], "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 7, "maximum": 1000 }, { "type": "string", "enum": [ "all" ] } ], "default": 30 }, "description": "All returns every retained daily observation without a row cap." } ], "x-cipherscan-legacy-path": "/api/privacy-stats", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Aggregate shielded-vs-transparent stats.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/stats/shielded-count": { "get": { "operationId": "get_stats_Shielded-count", "summary": "Running count of shielded transactions.", "tags": [ "stats" ], "parameters": [ { "name": "detailed", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "since", "in": "query", "required": true, "schema": { "type": "string", "format": "date" }, "description": "Start date (YYYY-MM-DD)." } ], "x-cipherscan-legacy-path": "/api/stats/shielded-count", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Running count of shielded transactions.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/stats/shielded-daily": { "get": { "operationId": "get_stats_Shielded-daily", "summary": "Daily shielded transaction counts.", "tags": [ "stats" ], "parameters": [ { "name": "since", "in": "query", "required": true, "schema": { "type": "string", "format": "date" }, "description": "Start date (YYYY-MM-DD)." }, { "name": "until", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/stats/shielded-daily", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Daily shielded transaction counts.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/risks": { "get": { "operationId": "get_privacy_Risks", "summary": "Per-transaction privacy risk indicators.", "tags": [ "privacy" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 20, "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "minScore", "in": "query", "required": false, "schema": { "default": 40, "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "default": 0, "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "period", "in": "query", "required": false, "schema": { "default": "7d", "type": "string", "enum": [ "24h", "7d", "30d", "90d" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "riskLevel", "in": "query", "required": false, "schema": { "default": "ALL", "type": "string", "enum": [ "ALL", "HIGH", "MEDIUM" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "sort", "in": "query", "required": false, "schema": { "default": "recent", "type": "string", "enum": [ "score", "recent" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/privacy/risks", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Per-transaction privacy risk indicators.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/linkage-edges": { "get": { "operationId": "get_privacy_Linkage-edges", "summary": "Precomputed address linkage edges.", "tags": [ "privacy" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 20, "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "minScore", "in": "query", "required": false, "schema": { "default": 40, "type": "integer", "minimum": 0, "maximum": 100 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "default": 0, "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "period", "in": "query", "required": false, "schema": { "default": "7d", "type": "string", "enum": [ "24h", "7d", "30d", "90d" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "riskLevel", "in": "query", "required": false, "schema": { "default": "ALL", "type": "string", "enum": [ "ALL", "HIGH", "MEDIUM" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "sort", "in": "query", "required": false, "schema": { "default": "recent", "type": "string", "enum": [ "score", "recent" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "txid", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" }, {} ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/privacy/linkage-edges", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Precomputed address linkage edges.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/batch-risks": { "get": { "operationId": "get_privacy_Batch-risks", "summary": "Batch deshield/for-shield risk detection.", "tags": [ "privacy" ], "parameters": [ { "name": "afterAmount", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "afterScore", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "default": 20, "type": "integer", "minimum": 1, "maximum": 50 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "minScore", "in": "query", "required": false, "schema": { "default": 35, "type": "integer", "minimum": 0, "maximum": 100 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "period", "in": "query", "required": false, "schema": { "default": "30d", "type": "string", "enum": [ "7d", "30d", "90d" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "riskLevel", "in": "query", "required": false, "schema": { "default": "ALL", "type": "string", "enum": [ "ALL", "HIGH", "MEDIUM" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "sort", "in": "query", "required": false, "schema": { "default": "score", "type": "string", "enum": [ "score", "recent" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/privacy/batch-risks", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Batch deshield/for-shield risk detection.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/clusters": { "get": { "operationId": "get_privacy_Clusters", "summary": "Precomputed batch clusters.", "tags": [ "privacy" ], "parameters": [ { "name": "afterAmount", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "afterScore", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "default": 20, "type": "integer", "minimum": 1, "maximum": 50 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "minScore", "in": "query", "required": false, "schema": { "default": 35, "type": "integer", "minimum": 0, "maximum": 100 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "period", "in": "query", "required": false, "schema": { "default": "30d", "type": "string", "enum": [ "7d", "30d", "90d" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "riskLevel", "in": "query", "required": false, "schema": { "default": "ALL", "type": "string", "enum": [ "ALL", "HIGH", "MEDIUM" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "sort", "in": "query", "required": false, "schema": { "default": "score", "type": "string", "enum": [ "score", "recent" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/privacy/clusters", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Precomputed batch clusters.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/graph/{txid}": { "get": { "operationId": "get_privacy_Graph_Txid", "summary": "Privacy linkage graph rooted at a transaction.", "tags": [ "privacy" ], "parameters": [ { "name": "txid", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/privacy/graph/:txid", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Privacy linkage graph rooted at a transaction.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/shield/{txid}/batch": { "get": { "operationId": "get_privacy_Shield_Txid_Batch", "summary": "Batch-shield linkage for a transaction.", "tags": [ "privacy" ], "parameters": [ { "name": "txid", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/privacy/shield/:txid/batch", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Batch-shield linkage for a transaction.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/patterns": { "get": { "operationId": "get_privacy_Patterns", "summary": "Detected privacy-relevant transaction patterns.", "tags": [ "privacy" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "riskLevel", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/privacy/patterns", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Detected privacy-relevant transaction patterns.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/common-amounts": { "get": { "operationId": "get_privacy_Common-amounts", "summary": "Observed public-flow amount buckets; not a measured anonymity set.", "tags": [ "privacy" ], "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/privacy/common-amounts", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Observed public-flow amount buckets; not a measured anonymity set.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/recommended-swap-amounts": { "get": { "operationId": "get_privacy_Recommended-swap-amounts", "summary": "Common round swap amounts observed in public flows; no privacy guarantee.", "tags": [ "privacy" ], "parameters": [ { "name": "chain", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "token", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/privacy/recommended-swap-amounts", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Common round swap amounts observed in public flows; no privacy guarantee.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/fee-lanes": { "get": { "operationId": "get_privacy_Fee-lanes", "summary": "Fee-lane privacy heuristics.", "tags": [ "privacy" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/privacy/fee-lanes", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Fee-lane privacy heuristics.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/wallet-fingerprints": { "get": { "operationId": "get_privacy_Wallet-fingerprints", "summary": "Wallet fingerprinting signal aggregates.", "tags": [ "privacy" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/privacy/wallet-fingerprints", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Wallet fingerprinting signal aggregates.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/anonymity-set": { "get": { "operationId": "get_privacy_Anonymity-set", "summary": "Counts of public shielding and deshielding flows at overlapping amount thresholds.", "tags": [ "privacy" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/analytics/anonymity-set", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Counts of public shielding and deshielding flows at overlapping amount thresholds.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/shielding-distribution": { "get": { "operationId": "get_privacy_Shielding-distribution", "summary": "Distribution of shielding behavior.", "tags": [ "privacy" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/analytics/shielding-distribution", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Distribution of shielding behavior.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/network/fee-distribution": { "get": { "operationId": "get_network_Fee-distribution", "summary": "Fee distribution histogram.", "tags": [ "network" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/network/fee-distribution", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Fee distribution histogram.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/analytics/usage-clock": { "get": { "operationId": "get_analytics_Usage-clock", "summary": "Time-of-day/week usage heatmap.", "tags": [ "analytics" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/analytics/usage-clock", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Time-of-day/week usage heatmap.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/blend-check": { "get": { "operationId": "get_privacy_Blend-check", "summary": "Transaction \"blend\" (mixing quality) check.", "tags": [ "privacy" ], "parameters": [ { "name": "amount", "in": "query", "required": true, "schema": { "type": "number", "exclusiveMinimum": 0, "maximum": 21000000 }, "description": "Amount in ZEC, greater than zero and at most 21 million." } ], "x-cipherscan-legacy-path": "/api/blend-check", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Transaction \"blend\" (mixing quality) check.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/privacy/blend-check/split": { "get": { "operationId": "get_privacy_Blend-check_Split", "summary": "Blend-check split breakdown.", "tags": [ "privacy" ], "parameters": [ { "name": "amount", "in": "query", "required": true, "schema": { "type": "number", "exclusiveMinimum": 0, "maximum": 21000000 }, "description": "Amount in ZEC, greater than zero and at most 21 million." } ], "x-cipherscan-legacy-path": "/api/blend-check/split", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Blend-check split breakdown.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/shielded-pools/overview": { "get": { "operationId": "get_shielded-pools_Overview", "summary": "Shielded pool balances and observed changes.", "tags": [ "shielded-pools" ], "x-cipherscan-legacy-path": "/api/pools/overview", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Shielded pool balances and observed changes.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/shielded-pools/flows": { "get": { "operationId": "get_shielded-pools_Flows", "summary": "Daily public shielding and deshielding flows.", "tags": [ "shielded-pools" ], "parameters": [ { "name": "format", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "granularity", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "pool", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/pools/flows", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Daily public shielding and deshielding flows.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/shielded-pools/turnstile": { "get": { "operationId": "get_shielded-pools_Turnstile", "summary": "Public deshielding cohorts and subsequent observed destinations.", "tags": [ "shielded-pools" ], "parameters": [ { "name": "since", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/pools/turnstile", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Public deshielding cohorts and subsequent observed destinations.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mining/software": { "get": { "operationId": "get_mining_Software", "summary": "Self-reported mining software markers: block-weighted shares, daily or weekly history, and indexed coverage.", "tags": [ "mining" ], "parameters": [ { "name": "bucket", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "auto", "day", "week" ], "default": "auto", "description": "Auto selects weekly for ranges longer than 121 days. Weekly buckets start Monday; boundary weeks contain only requested days." }, "description": "Auto selects weekly for ranges longer than 121 days. Weekly buckets start Monday; boundary weeks contain only requested days." }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "description": "Inclusive UTC date, YYYY-MM-DD. Mining software history requires period=custom." }, "description": "Inclusive UTC date, YYYY-MM-DD. Mining software history requires period=custom." }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "7d", "30d", "90d", "1y", "all", "custom", "since-zebra", "since-zakura" ], "default": "30d", "description": "UTC calendar-day range. Since presets begin on the first observed marker day, not the software launch." }, "description": "UTC calendar-day range. Since presets begin on the first observed marker day, not the software launch." }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "description": "Inclusive UTC end date, YYYY-MM-DD. Mining software history requires period=custom." }, "description": "Inclusive UTC end date, YYYY-MM-DD. Mining software history requires period=custom." } ], "x-cipherscan-legacy-path": "/api/mining/software", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Self-reported mining software markers: block-weighted shares, daily or weekly history, and indexed coverage.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mining/pool-distribution": { "get": { "operationId": "get_mining_Pool-distribution", "summary": "Mining pool hashrate distribution.", "tags": [ "mining" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/mining/pool-distribution", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Mining pool hashrate distribution.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mining/pool-ranking": { "get": { "operationId": "get_mining_Pool-ranking", "summary": "Ranked mining pools.", "tags": [ "mining" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/mining/pool-ranking", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Ranked mining pools.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mining/hashrate-share": { "get": { "operationId": "get_mining_Hashrate-share", "summary": "Hashrate share over time.", "tags": [ "mining" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/mining/hashrate-share", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Hashrate share over time.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mining/rewards": { "get": { "operationId": "get_mining_Rewards", "summary": "Block reward accounting.", "tags": [ "mining" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/mining/rewards", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Block reward accounting.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mining/miner-behavior": { "get": { "operationId": "get_mining_Miner-behavior", "summary": "Miner behavior heuristics.", "tags": [ "mining" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/mining/miner-behavior", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Miner behavior heuristics.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mining/zodl-leaderboard": { "get": { "operationId": "get_mining_Zodl-leaderboard", "summary": "ZODL miner leaderboard.", "tags": [ "mining" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/mining/zodl-leaderboard", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "ZODL miner leaderboard.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/migration/overview": { "get": { "operationId": "get_migration_Overview", "summary": "Sapling→Orchard/Ironwood migration overview.", "tags": [ "migration" ], "x-cipherscan-legacy-path": "/api/migration/overview", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Sapling→Orchard/Ironwood migration overview.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/migration/cohorts": { "get": { "operationId": "get_migration_Cohorts", "summary": "Migration cohort breakdown.", "tags": [ "migration" ], "x-cipherscan-legacy-path": "/api/migration/cohorts", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Migration cohort breakdown.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/migration/denominations": { "get": { "operationId": "get_migration_Denominations", "summary": "Migration by amount denomination.", "tags": [ "migration" ], "x-cipherscan-legacy-path": "/api/migration/denominations", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Migration by amount denomination.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/migration/activity": { "get": { "operationId": "get_migration_Activity", "summary": "Compact hourly/daily migration activity buckets for time-series charts.", "tags": [ "migration" ], "parameters": [ { "name": "granularity", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/migration/activity", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Compact hourly/daily migration activity buckets for time-series charts.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/migration/summary": { "get": { "operationId": "get_migration_Summary", "summary": "Small, fixed-size digest of migration activity (headline totals + 24h/7d windows).", "tags": [ "migration" ], "x-cipherscan-legacy-path": "/api/migration/summary", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Small, fixed-size digest of migration activity (headline totals + 24h/7d windows).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/migration/scatter": { "get": { "operationId": "get_migration_Scatter", "summary": "Individual migration transactions with privacy classification (measured ~10.4MB response at current chain height).", "tags": [ "migration" ], "x-cipherscan-legacy-path": "/api/migration/scatter", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Individual migration transactions with privacy classification (measured ~10.4MB response at current chain height).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/migration/scatter/compact": { "get": { "operationId": "get_migration_Scatter_Compact", "summary": "Versioned compact migration points with bounded ranges, finalized chunks, ETags, and incremental canonical-tail cursors.", "tags": [ "migration" ], "parameters": [ { "name": "afterHash", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "afterHeight", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "chunkStart", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "manifest", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/migration/scatter/compact", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Versioned compact migration points with bounded ranges, finalized chunks, ETags, and incremental canonical-tail cursors.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/migration/tiers": { "get": { "operationId": "get_migration_Tiers", "summary": "Migration progress by holding tier.", "tags": [ "migration" ], "x-cipherscan-legacy-path": "/api/migration/tiers", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Migration progress by holding tier.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/valuation/search-interest": { "get": { "operationId": "get_valuation_Search-interest", "summary": "Imported Google Trends weekly observations, with provenance and provisional-week flags. Not a live feed or a valuation signal.", "tags": [ "valuation" ], "x-cipherscan-legacy-path": "/api/valuation/search-interest", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Imported Google Trends weekly observations, with provenance and provisional-week flags. Not a live feed or a valuation signal.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/valuation/snapshot": { "get": { "operationId": "get_valuation_Snapshot", "summary": "Current valuation snapshot.", "tags": [ "valuation" ], "x-cipherscan-legacy-path": "/api/valuation/snapshot", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Current valuation snapshot.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/valuation/history": { "get": { "operationId": "get_valuation_History", "summary": "Historical valuation series.", "tags": [ "valuation" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "30d", "90d", "180d", "1y", "2y", "all" ], "default": "1y" }, "description": "All returns the complete available daily history." } ], "x-cipherscan-legacy-path": "/api/valuation/history", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Historical valuation series.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/valuation/hodl-waves": { "get": { "operationId": "get_valuation_Hodl-waves", "summary": "HODL wave age-band breakdown.", "tags": [ "valuation" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "30d", "90d", "180d", "1y", "2y", "all" ], "default": "1y" }, "description": "All returns the complete available daily history." } ], "x-cipherscan-legacy-path": "/api/valuation/hodl-waves", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "HODL wave age-band breakdown.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/valuation/dormancy": { "get": { "operationId": "get_valuation_Dormancy", "summary": "Coin dormancy metrics.", "tags": [ "valuation" ], "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "30d", "90d", "180d", "1y", "2y", "all" ], "default": "1y" }, "description": "All returns the complete available daily history." } ], "x-cipherscan-legacy-path": "/api/valuation/dormancy", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Coin dormancy metrics.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/pulse": { "get": { "operationId": "get_pulse", "summary": "Real-time \"pulse\" activity feed.", "tags": [ "pulse" ], "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "metric", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/pulse", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Real-time \"pulse\" activity feed.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/pulse/summary": { "get": { "operationId": "get_pulse_Summary", "summary": "Pulse summary metrics.", "tags": [ "pulse" ], "x-cipherscan-legacy-path": "/api/pulse/summary", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Pulse summary metrics.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transparent/exposed": { "get": { "operationId": "get_transparent_Exposed", "summary": "Transparent addresses with exposed-linkage risk.", "tags": [ "transparent" ], "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^t[a-zA-Z0-9]+$" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "default": 100, "type": "integer", "minimum": 1, "maximum": 1000 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "min_balance", "in": "query", "required": false, "schema": { "default": 0, "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "default": 0, "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "sort", "in": "query", "required": false, "schema": { "default": "balance", "type": "string", "enum": [ "balance", "address" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/transparent/exposed", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Transparent addresses with exposed-linkage risk.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transparent/exposed/summary": { "get": { "operationId": "get_transparent_Exposed_Summary", "summary": "Summary of transparent exposure risk.", "tags": [ "transparent" ], "x-cipherscan-legacy-path": "/api/transparent/exposed/summary", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Summary of transparent exposure risk.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/labels": { "get": { "operationId": "get_labels", "summary": "Known-address label directory.", "tags": [ "address" ], "x-cipherscan-legacy-path": "/api/labels", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Known-address label directory.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/labels/{address}": { "get": { "operationId": "get_labels_Address", "summary": "Label for one address.", "tags": [ "address" ], "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/label/:address", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Label for one address.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/addresses/rich-list": { "get": { "operationId": "get_addresses_Rich-list", "summary": "Top addresses by transparent balance.", "tags": [ "address" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/rich-list", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Top addresses by transparent balance.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/addresses/{address}": { "get": { "operationId": "get_addresses_Address", "summary": "Address summary and snapshot-paginated transaction history. Send page and limit; follow pagination.nextCursor, prevCursor or lastCursor with the corresponding page. Cursors expire after one hour, a service restart or a reorg (409: reload without cursor). Numeric pages are supported within 100,000 rows of either end; use cursors for deeper traversal. Overview balances are current; pagination.total and snapshotHeight describe the frozen history.", "tags": [ "address" ], "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "page", "in": "query", "required": false, "schema": { "default": 1, "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/address/:address", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Address summary and snapshot-paginated transaction history. Send page and limit; follow pagination.nextCursor, prevCursor or lastCursor with the corresponding page. Cursors expire after one hour, a service restart or a reorg (409: reload without cursor). Numeric pages are supported within 100,000 rows of either end; use cursors for deeper traversal. Overview balances are current; pagination.total and snapshotHeight describe the frozen history.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/addresses/{address}/graph": { "get": { "operationId": "get_addresses_Address_Graph", "summary": "Address cluster/linkage graph.", "tags": [ "address" ], "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/address/:address/graph", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Address cluster/linkage graph.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/finalizers": { "get": { "operationId": "get_crosslink_Finalizers", "summary": "Crosslink BFT finalizer set.", "tags": [ "crosslink" ], "parameters": [ { "name": "active", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/finalizers", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Crosslink BFT finalizer set.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/finalizers/{pubkey}/participation": { "get": { "operationId": "get_crosslink_Finalizers_Pubkey_Participation", "summary": "Finalizer participation history.", "tags": [ "crosslink" ], "parameters": [ { "name": "pubkey", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "window", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/finalizer/:pubkey/participation", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Finalizer participation history.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/participation": { "get": { "operationId": "get_crosslink_Participation", "summary": "Aggregate finalizer participation.", "tags": [ "crosslink" ], "parameters": [ { "name": "window", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/crosslink/participation", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Aggregate finalizer participation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/bft-chain": { "get": { "operationId": "get_crosslink_Bft-chain", "summary": "BFT finalized chain segment.", "tags": [ "crosslink" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/crosslink/bft-chain", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "BFT finalized chain segment.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/finalizers/{pubkey}": { "get": { "operationId": "get_crosslink_Finalizers_Pubkey", "summary": "Single finalizer detail.", "tags": [ "crosslink" ], "parameters": [ { "name": "pubkey", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/finalizer/:pubkey", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Single finalizer detail.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink": { "get": { "operationId": "get_crosslink", "summary": "Crosslink overview stats.", "tags": [ "crosslink" ], "x-cipherscan-legacy-path": "/api/crosslink", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Crosslink overview stats.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/bft-tip": { "get": { "operationId": "get_crosslink_Bft-tip", "summary": "Current BFT-finalized tip.", "tags": [ "crosslink" ], "x-cipherscan-legacy-path": "/api/crosslink/bft-tip", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Current BFT-finalized tip.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/bootstrap-info": { "get": { "operationId": "get_crosslink_Bootstrap-info", "summary": "Crosslink bootstrap parameters.", "tags": [ "crosslink" ], "x-cipherscan-legacy-path": "/api/crosslink/bootstrap-info", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Crosslink bootstrap parameters.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/divergence-history": { "get": { "operationId": "get_crosslink_Divergence-history", "summary": "PoW/BFT chain divergence history.", "tags": [ "crosslink" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/crosslink/divergence-history", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "PoW/BFT chain divergence history.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/fork-monitor": { "get": { "operationId": "get_crosslink_Fork-monitor", "summary": "Fork monitor dashboard (reported node tips vs. cTAZ).", "tags": [ "crosslink" ], "x-cipherscan-legacy-path": "/api/crosslink/fork-monitor", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Fork monitor dashboard (reported node tips vs. cTAZ).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/fork-monitor/checks": { "post": { "operationId": "post_crosslink_Fork-monitor_Checks", "summary": "Live hash comparison at up to 10 heights (read-only RPC, no writes).", "tags": [ "crosslink" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "heights" ], "properties": { "heights": { "type": "array", "minItems": 1, "maxItems": 10, "items": { "type": "integer", "minimum": 0, "maximum": 100000000 } } } } } } }, "x-cipherscan-legacy-path": "/api/crosslink/fork-monitor/check", "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Live hash comparison at up to 10 heights (read-only RPC, no writes).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/block-hash/{height}": { "get": { "operationId": "get_crosslink_Block-hash_Height", "summary": "Block hash at a given height (used by external fork-finder scripts).", "tags": [ "crosslink" ], "parameters": [ { "name": "height", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/crosslink/block-hash/:height", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Block hash at a given height (used by external fork-finder scripts).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/fork-monitor/nodes": { "post": { "operationId": "post_crosslink_Fork-monitor_Nodes", "summary": "Voluntary node self-registration for the fork monitor (per-name rate limited, capacity-bounded upstream).", "tags": [ "crosslink" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "tip" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 32 }, "tip": { "type": "integer", "minimum": 0, "maximum": 100000000 }, "tip_hash": { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" }, "peers": { "type": "integer", "minimum": 0, "maximum": 10000 }, "mining": { "type": "boolean" }, "ttl": { "type": "string", "enum": [ "1h", "24h" ] }, "sample_hashes": { "type": "array", "maxItems": 12, "items": { "type": "object", "required": [ "height", "hash" ], "properties": { "height": { "type": "integer", "minimum": 0, "maximum": 100000000 }, "hash": { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" } } } } } } } } }, "parameters": [ { "name": "X-Node-Token", "in": "header", "required": false, "schema": { "type": "string" }, "description": "Ownership token returned when registering the node. Required to modify or remove an existing registration." } ], "x-cipherscan-legacy-path": "/api/crosslink/fork-monitor/report", "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Voluntary node self-registration for the fork monitor (per-name rate limited, capacity-bounded upstream).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/crosslink/fork-monitor/nodes/{name}": { "delete": { "operationId": "delete_crosslink_Fork-monitor_Nodes_Name", "summary": "Delete a node report using its registration ownership token.", "tags": [ "crosslink" ], "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-Node-Token", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Ownership token returned when registering the node. Required to modify or remove an existing registration." } ], "x-cipherscan-legacy-path": "/api/crosslink/fork-monitor/report/:name", "x-cipherscan-legacy-method": "DELETE", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Delete a node report using its registration ownership token.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/uncles": { "get": { "operationId": "get_uncles", "summary": "Recent orphaned blocks (\"uncles\").", "tags": [ "reorgs" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/uncles", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Recent orphaned blocks (\"uncles\").", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/uncles/forks": { "get": { "operationId": "get_uncles_Forks", "summary": "Detected chain forks.", "tags": [ "reorgs" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/uncles/forks", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Detected chain forks.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/uncles/{hash}": { "get": { "operationId": "get_uncles_Hash", "summary": "Single orphaned block detail.", "tags": [ "reorgs" ], "parameters": [ { "name": "hash", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/uncle/:hash", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Single orphaned block detail.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/uncles/reports": { "post": { "operationId": "post_uncles_Reports", "summary": "Report an observed tip hash for comparison (IP rate limited, PoW-shape validated upstream).", "tags": [ "reorgs" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "height", "hash" ], "properties": { "height": { "type": "integer", "minimum": 0, "maximum": 100000000 }, "hash": { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" }, "node_id": { "type": "string" } } } } } }, "x-cipherscan-legacy-path": "/api/uncle/report", "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Report an observed tip hash for comparison (IP rate limited, PoW-shape validated upstream).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/uncles/stats": { "get": { "operationId": "get_uncles_Stats", "summary": "Reorg/orphan dashboard stats.", "tags": [ "reorgs" ], "x-cipherscan-legacy-path": "/api/uncles/stats", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Reorg/orphan dashboard stats.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/uncles/nodes": { "get": { "operationId": "get_uncles_Nodes", "summary": "Reporting node list for the reorg dashboard.", "tags": [ "reorgs" ], "x-cipherscan-legacy-path": "/api/uncles/nodes", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Reporting node list for the reorg dashboard.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transactions": { "get": { "operationId": "get_transactions", "summary": "Cursor-paginated transaction list with type filter.", "tags": [ "transactions" ], "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor from a previous response's meta.page.nextCursor/prevCursor.", "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/transactions/list", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Cursor-paginated transaction list with type filter.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": {} }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transactions/shielded": { "get": { "operationId": "get_transactions_Shielded", "summary": "Shielding, deshielding and fully shielded transaction collection.", "tags": [ "transactions" ], "parameters": [ { "name": "flow_type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "min_zec", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "pool", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor from a previous response's meta.page.nextCursor/prevCursor.", "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/shielded/list", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Shielding, deshielding and fully shielded transaction collection.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": {} }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transactions/shielded-summary": { "get": { "operationId": "get_transactions_Shielded-summary", "summary": "Shielded transaction summary metrics.", "tags": [ "transactions" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "min_actions", "in": "query", "required": false, "schema": { "default": 0, "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "offset", "in": "query", "required": false, "schema": { "default": 0, "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "pool", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "sapling", "orchard", "ironwood" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "skip_count", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "fully-shielded", "partial" ] }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/tx/shielded", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Shielded transaction summary metrics.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transactions/{txid}/linkability": { "get": { "operationId": "get_transactions_Txid_Linkability", "summary": "Linkability analysis for one transaction.", "tags": [ "transactions" ], "parameters": [ { "name": "txid", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "default": 5, "type": "integer", "minimum": 1, "maximum": 20 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." }, { "name": "tolerance", "in": "query", "required": false, "schema": { "default": 0.001, "type": "number", "minimum": 0.0001, "maximum": 0.1 }, "description": "Endpoint-specific filter or range; accepted values follow this endpoint’s data source." } ], "x-cipherscan-legacy-path": "/api/tx/:txid/linkability", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Linkability analysis for one transaction.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transactions/broadcast": { "post": { "operationId": "post_transactions_Broadcast", "summary": "Broadcast a fully-signed raw transaction (no keys involved).", "tags": [ "transactions" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "rawTx" ], "properties": { "rawTx": { "type": "string", "pattern": "^[a-fA-F0-9]+$", "description": "Already signed serialized transaction. No private key is accepted." } } } } } }, "x-cipherscan-legacy-path": "/api/tx/broadcast", "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Broadcast a fully-signed raw transaction (no keys involved).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mempool": { "get": { "operationId": "get_mempool", "summary": "Current mempool transaction summaries.", "tags": [ "mempool" ], "x-cipherscan-legacy-path": "/api/mempool", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Current mempool transaction summaries.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/mempool/{txid}": { "get": { "operationId": "get_mempool_Txid", "summary": "Single mempool transaction detail.", "tags": [ "mempool" ], "parameters": [ { "name": "txid", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/mempool/tx/:txid", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Single mempool transaction detail.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transactions/{txid}/raw": { "get": { "operationId": "get_transactions_Txid_Raw", "summary": "Raw transaction hex.", "tags": [ "transactions" ], "parameters": [ { "name": "txid", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/tx/:txid/raw", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Raw transaction hex.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transactions/{txid}/verbose": { "get": { "operationId": "get_transactions_Txid_Verbose", "summary": "Verbose decoded transaction (zebra getrawtransaction verbose=1).", "tags": [ "transactions" ], "parameters": [ { "name": "txid", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/tx/:txid/verbose", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Verbose decoded transaction (zebra getrawtransaction verbose=1).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transactions/raw/batch": { "post": { "operationId": "post_transactions_Raw_Batch", "summary": "Batch raw-tx fetch by txid list (read-only despite POST verb; body carries the id list).", "tags": [ "transactions" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "txids" ], "properties": { "txids": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" } } } } } } }, "x-cipherscan-legacy-path": "/api/tx/raw/batch", "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Batch raw-tx fetch by txid list (read-only despite POST verb; body carries the id list).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/transactions/{txid}": { "get": { "operationId": "get_transactions_Txid", "summary": "Full transaction detail (inputs, outputs, cross-chain bridge match).", "tags": [ "transactions" ], "parameters": [ { "name": "txid", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cipherscan-legacy-path": "/api/tx/:txid", "x-cipherscan-legacy-method": "GET", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "responses": { "200": { "description": "Full transaction detail (inputs, outputs, cross-chain bridge match).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/scan/orchard": { "post": { "operationId": "post_scan_Orchard", "summary": "Batch-scan a height range for Orchard transactions (wallet scanning aid).", "tags": [ "scan" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "startHeight", "endHeight" ], "properties": { "startHeight": { "type": "integer", "minimum": 0 }, "endHeight": { "type": "integer", "minimum": 0 } }, "description": "Inclusive block range. Maximum 10,000 blocks for lightwalletd or 50,000 for Orchard by default; configured server limits may differ." } } } }, "x-cipherscan-legacy-path": "/api/scan/orchard", "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "x-cipherscan-v1-validation": "scanOrchard", "x-cipherscan-v1-rate-limit-key": "scanOrchard", "responses": { "200": { "description": "Batch-scan a height range for Orchard transactions (wallet scanning aid).", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/scan/lightwalletd": { "post": { "operationId": "post_scan_Lightwalletd", "summary": "Batch-scan blocks via Lightwalletd gRPC for client-side trial decryption.", "tags": [ "scan" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "startHeight", "endHeight" ], "properties": { "startHeight": { "type": "integer", "minimum": 1 }, "endHeight": { "type": "integer", "minimum": 0 } }, "description": "Inclusive block range. Maximum 10,000 blocks for lightwalletd or 50,000 for Orchard by default; configured server limits may differ." } } } }, "x-cipherscan-legacy-path": "/api/lightwalletd/scan", "x-cipherscan-legacy-method": "POST", "x-cipherscan-classification": "public", "x-cipherscan-v1-status": "adapter", "x-cipherscan-v1-validation": "scanLightwalletd", "x-cipherscan-v1-rate-limit-key": "scanLightwalletd", "responses": { "200": { "description": "Batch-scan blocks via Lightwalletd gRPC for client-side trial decryption.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "oneOf": [ { "type": "object" }, { "type": "array", "items": {} } ] }, "meta": { "$ref": "#/components/schemas/Meta" } } } } } }, "400": { "description": "Validation error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Preview or endpoint authentication required.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Payment required. Protocol challenges remain in Payment-Required / WWW-Authenticate; the original challenge is also in problem.paymentRequired.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Origin or ownership authorization denied.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Resource not found.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "JSON body exceeds 1 MB.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limited (enforced by the legacy endpoint this proxies to).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "502": { "description": "Upstream (legacy API) error.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Source temporarily unavailable or still building.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "504": { "description": "Upstream (legacy API) timeout.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } } } }