{"openapi":"3.1.0","info":{"title":"ALGOMetrics API","version":"0.1.0","description":"Algorand protocol economics metrics with x402-gated programmatic endpoints."},"servers":[{"url":"https://api.algometrics.org"}],"paths":{"/health":{"get":{"summary":"Health check","responses":{"200":{"description":"Service health"}}}},"/v1/methodology":{"get":{"summary":"Published methodology","responses":{"200":{"description":"Methodology notes"}}}},"/v1/metrics/summary":{"get":{"summary":"Summary metrics","parameters":[{"name":"methodology","in":"query","required":false,"description":"Set to `full` to inline the complete methodology prose in the response. Omitted by default; the prose otherwise lives at /v1/methodology (see `methodologyRef`).","schema":{"type":"string","enum":["full"]}}],"responses":{"200":{"description":"Metric response"},"402":{"description":"Payment required"}}}},"/v1/metrics/issuance":{"get":{"summary":"Issuance metrics","parameters":[{"name":"methodology","in":"query","required":false,"description":"Set to `full` to inline the complete methodology prose in the response. Omitted by default; the prose otherwise lives at /v1/methodology (see `methodologyRef`).","schema":{"type":"string","enum":["full"]}}],"responses":{"200":{"description":"Metric response"},"402":{"description":"Payment required"}}}},"/v1/metrics/fees":{"get":{"summary":"Fee and burn metrics","parameters":[{"name":"methodology","in":"query","required":false,"description":"Set to `full` to inline the complete methodology prose in the response. Omitted by default; the prose otherwise lives at /v1/methodology (see `methodologyRef`).","schema":{"type":"string","enum":["full"]}}],"responses":{"200":{"description":"Metric response"},"402":{"description":"Payment required"}}}},"/v1/metrics/staking":{"get":{"summary":"Staking and decentralization metrics (phase-3 stub, free, returns nulls)","responses":{"200":{"description":"Metric response"}}}},"/v1/metrics/projections":{"get":{"summary":"Projection metrics","parameters":[{"name":"methodology","in":"query","required":false,"description":"Set to `full` to inline the complete methodology prose in the response. Omitted by default; the prose otherwise lives at /v1/methodology (see `methodologyRef`).","schema":{"type":"string","enum":["full"]}}],"responses":{"200":{"description":"Metric response"},"402":{"description":"Payment required"}}}},"/v1/metrics/microstructure":{"get":{"summary":"ALGO-USD market microstructure metrics (VPIN, order-flow imbalance) from Coinbase trade data","parameters":[{"name":"methodology","in":"query","required":false,"description":"Set to `full` to inline the complete methodology prose in the response. Omitted by default; the prose otherwise lives at /v1/methodology (see `methodologyRef`).","schema":{"type":"string","enum":["full"]}}],"responses":{"200":{"description":"Metric response"},"402":{"description":"Payment required"}}}},"/v1/metrics/market-depth":{"get":{"summary":"ALGO-USD market depth: Kyle lambda and estimated USD notional for a $0.01 or one-basis-point price move","parameters":[{"name":"methodology","in":"query","required":false,"description":"Set to `full` to inline the complete methodology prose in the response. Omitted by default; the prose otherwise lives at /v1/methodology (see `methodologyRef`).","schema":{"type":"string","enum":["full"]}}],"responses":{"200":{"description":"Metric response"},"402":{"description":"Payment required"}}}},"/v1/metrics/adverse-selection-risk":{"get":{"summary":"ALGO-USD adverse-selection risk: VPIN, 0.5 threshold status, and interpretation guidance","parameters":[{"name":"methodology","in":"query","required":false,"description":"Set to `full` to inline the complete methodology prose in the response. Omitted by default; the prose otherwise lives at /v1/methodology (see `methodologyRef`).","schema":{"type":"string","enum":["full"]}}],"responses":{"200":{"description":"Metric response"},"402":{"description":"Payment required"}}}},"/v1/metrics/microstructure/interpretation":{"get":{"summary":"Claude-generated interpretation of current ALGO-USD market conditions (premium-priced; includes the underlying metrics snapshot)","parameters":[{"name":"methodology","in":"query","required":false,"description":"Set to `full` to inline the complete methodology prose in the response. Omitted by default; the prose otherwise lives at /v1/methodology (see `methodologyRef`).","schema":{"type":"string","enum":["full"]}}],"responses":{"200":{"description":"Metric response"},"402":{"description":"Payment required"}}}},"/mcp":{"post":{"summary":"MCP JSON-RPC endpoint exposing the protocol-economics and microstructure metrics as agent tools. initialize and tools/list are free; tools/call is x402-priced at the base rate, or the premium rate for the Claude interpretation tool.","responses":{"200":{"description":"MCP JSON-RPC response"},"402":{"description":"Payment required (tools/call only)"}}}}}}