{"openapi":"3.1.0","info":{"title":"Blocksize Agentic Market Intelligence","description":"\nInstitutional-grade real-time market data gateway for autonomous AI agents.\nSupports x402 USDC settlement, wallet credits, and a public read-only remote\nMCP discovery surface for directory listings and client onboarding.\n\n### Public Integration Surfaces\n- **Developer Portal**: [Homepage](https://mcp.blocksize.info/)\n- **Remote MCP URL**: [Streamable HTTP](https://mcp.blocksize.info/mcp/server/)\n- **MCP Manifest**: [Listing metadata](https://mcp.blocksize.info/mcp/manifest.json)\n- **OpenAPI**: [JSON schema](https://mcp.blocksize.info/openapi.json)\n- **Swagger UI**: [Interactive docs](https://mcp.blocksize.info/docs)\n- **Quickstart**: [Remote MCP install guide](https://mcp.blocksize.info/quickstart/remote-mcp)\n- **Prompt Examples**: [Example prompts](https://mcp.blocksize.info/prompt-examples)\n- **Privacy Policy**: [Privacy](https://mcp.blocksize.info/privacy)\n- **Support**: [Contact and troubleshooting](https://mcp.blocksize.info/support)\n    ","version":"0.6.2"},"paths":{"/v1/products":{"get":{"summary":"Get Products","description":"Serve raw data and premium workflow product catalog. FREE.","operationId":"get_products_v1_products_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Products V1 Products Get"}}}}}}},"/v1/vwap/{pair}":{"get":{"summary":"Get Vwap","description":"Get real-time VWAP for a crypto pair. Cost: $0.002–$0.004 USDC.","operationId":"get_vwap_v1_vwap__pair__get","parameters":[{"name":"pair","in":"path","required":true,"schema":{"type":"string","title":"Pair"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Vwap V1 Vwap  Pair  Get"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.002","max":"0.004"},"protocols":[{"x402":{}}]}}},"/v1/bidask/{pair}":{"get":{"summary":"Get Bidask","description":"Get bid/ask snapshot for a shared symbol. Cost: $0.002–$0.008 USDC.","operationId":"get_bidask_v1_bidask__pair__get","parameters":[{"name":"pair","in":"path","required":true,"schema":{"type":"string","title":"Pair"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Bidask V1 Bidask  Pair  Get"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.002","max":"0.008"},"protocols":[{"x402":{}}]}}},"/v1/state/{pair}":{"get":{"summary":"Get State Price Endpoint","description":"Get pool-derived state price for a covered crypto/protocol pair.","operationId":"get_state_price_endpoint_v1_state__pair__get","parameters":[{"name":"pair","in":"path","required":true,"schema":{"type":"string","title":"Pair"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get State Price Endpoint V1 State  Pair  Get"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.002","max":"0.004"},"protocols":[{"x402":{}}]}}},"/v1/vwap30m/{pair}":{"get":{"summary":"Get Vwap 30M Endpoint","description":"Get latest completed 30-minute close via Blocksize closingprice_list.","operationId":"get_vwap_30m_endpoint_v1_vwap30m__pair__get","parameters":[{"name":"pair","in":"path","required":true,"schema":{"type":"string","title":"Pair"}},{"name":"include_trades","in":"query","required":false,"schema":{"type":"boolean","description":"Include closingprice_trades evidence","default":false,"title":"Include Trades"},"description":"Include closingprice_trades evidence"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Vwap 30M Endpoint V1 Vwap30M  Pair  Get"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.002","max":"0.004"},"protocols":[{"x402":{}}]}}},"/v1/vwap24h/{pair}":{"get":{"summary":"Get Vwap 24H Endpoint","description":"Get true 24-hour fixed VWAP from the websocket-backed cache.","operationId":"get_vwap_24h_endpoint_v1_vwap24h__pair__get","parameters":[{"name":"pair","in":"path","required":true,"schema":{"type":"string","title":"Pair"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Vwap 24H Endpoint V1 Vwap24H  Pair  Get"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.002","max":"0.004"},"protocols":[{"x402":{}}]}}},"/v1/fx/{pair}":{"get":{"summary":"Get Fx","description":"Get FX rate. Cost: $0.005 USDC.","operationId":"get_fx_v1_fx__pair__get","parameters":[{"name":"pair","in":"path","required":true,"schema":{"type":"string","title":"Pair"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Fx V1 Fx  Pair  Get"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]}}},"/v1/metal/{ticker}":{"get":{"summary":"Get Metal","description":"Get metal spot price. Cost: $0.005 USDC.","operationId":"get_metal_v1_metal__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Metal V1 Metal  Ticker  Get"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]}}},"/v1/batch":{"get":{"summary":"Batch Request","description":"Execute a batch of data queries.\nPass a comma separated list of svc:pair in the `reqs` query parameter.\nExample: /v1/batch?reqs=vwap:BTCUSD,bidask:ETHUSD,fx:EURUSD","operationId":"batch_request_v1_batch_get","parameters":[{"name":"reqs","in":"query","required":true,"schema":{"type":"string","title":"Reqs"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Batch Request V1 Batch Get"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.002","max":"0.400"},"protocols":[{"x402":{}}]}}},"/v1/capabilities/check":{"post":{"summary":"Check Data Capabilities","description":"Check whether the current key has enough feed coverage for a product.\n\nThis is a free readiness check. It uses instrument catalogs and known method\navailability, not paid price snapshots.","operationId":"check_data_capabilities_v1_capabilities_check_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Check Data Capabilities V1 Capabilities Check Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/briefs/market":{"post":{"summary":"Agent Market Brief","description":"Create a decision-ready market brief. Cost: 10 credits or $0.25 USDC.","operationId":"agent_market_brief_v1_briefs_market_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agent Market Brief V1 Briefs Market Post"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/checks/pre-trade":{"post":{"summary":"Pre Trade Sanity Check","description":"Run a read-only pre-trade sanity check. Cost: 5 credits or $0.10 USDC.","operationId":"pre_trade_sanity_check_v1_checks_pre_trade_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pre Trade Sanity Check V1 Checks Pre Trade Post"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipts/price":{"post":{"summary":"Audit Grade Price Receipt","description":"Create an audit-grade receipt for one price lookup. Cost: 10 credits or $0.25 USDC.","operationId":"audit_grade_price_receipt_v1_receipts_price_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Audit Grade Price Receipt V1 Receipts Price Post"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/snapshots/macro":{"post":{"summary":"Multi Asset Macro Snapshot","description":"Create a bounded multi-asset macro snapshot. Cost: 25 credits or $1.00 USDC.","operationId":"multi_asset_macro_snapshot_v1_snapshots_macro_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Multi Asset Macro Snapshot V1 Snapshots Macro Post"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/monitors/evaluate":{"post":{"summary":"Spend Controlled Market Monitor","description":"Evaluate a bounded market monitor immediately. Cost: 10 credits or $0.25 USDC.","operationId":"spend_controlled_market_monitor_v1_monitors_evaluate_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Spend Controlled Market Monitor V1 Monitors Evaluate Post"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/token-quality":{"post":{"summary":"Token Market Quality Indicator","description":"Score one token using live price, bid/ask, state, and VWAP-window feeds.","operationId":"token_market_quality_indicator_v1_indicators_token_quality_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Token Market Quality Indicator V1 Indicators Token Quality Post"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/state-divergence":{"post":{"summary":"State Divergence Indicator","description":"Compare Blocksize market prices with state/reference prices.","operationId":"state_divergence_indicator_v1_indicators_state_divergence_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response State Divergence Indicator V1 Indicators State Divergence Post"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/signals/solana-token-brief":{"post":{"summary":"Solana Token Brief","description":"Build a Solana-oriented token signal brief for supported price symbols.","operationId":"solana_token_brief_v1_signals_solana_token_brief_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Solana Token Brief V1 Signals Solana Token Brief Post"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/signals/trader-alpha-pack":{"post":{"summary":"Trader Alpha Pack","description":"Bundle token quality indicators and macro context into a trader signal pack.","operationId":"trader_alpha_pack_v1_signals_trader_alpha_pack_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Trader Alpha Pack V1 Signals Trader Alpha Pack Post"}}}},"402":{"description":"Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded x402 PaymentRequired object.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"x402Version":2,"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"recipient-wallet","maxTimeoutSeconds":30}],"networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provenance/{receipt_id}":{"get":{"summary":"Lookup Price Receipt","description":"Lookup provenance for a prior paid or credited call. FREE when receipt exists.","operationId":"lookup_price_receipt_v1_provenance__receipt_id__get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Lookup Price Receipt V1 Provenance  Receipt Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search":{"get":{"summary":"Search Pairs","description":"Search instruments. FREE.","operationId":"search_pairs_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"asset_class","in":"query","required":false,"schema":{"type":"string","pattern":"^(all|crypto|equity|equities|fx|metal)$","description":"Asset class filter","default":"all","title":"Asset Class"},"description":"Asset class filter"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Pairs V1 Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/instruments/{service}":{"get":{"summary":"List Instruments","description":"List instruments for a service. FREE.","operationId":"list_instruments_v1_instruments__service__get","parameters":[{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Instruments V1 Instruments  Service  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cache/status":{"get":{"summary":"Get Cache Status","description":"Report stream-cache readiness for websocket-backed feeds. FREE.","operationId":"get_cache_status_v1_cache_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Cache Status V1 Cache Status Get"}}}}}}},"/v1/credits/balance/{wallet}":{"get":{"summary":"Get Credit Balance","description":"View current drawdown credit balance for a specific wallet.","operationId":"get_credit_balance_v1_credits_balance__wallet__get","parameters":[{"name":"wallet","in":"path","required":true,"schema":{"type":"string","title":"Wallet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/credits/purchase":{"post":{"summary":"Purchase Credits Challenge","description":"Triggers an x402 challenge for bulk credits.\nTiers: starter ($0.90), pro ($8.00), institutional ($60.00)","operationId":"purchase_credits_challenge_v1_credits_purchase_post","parameters":[{"name":"tier","in":"query","required":true,"schema":{"type":"string","pattern":"^(starter|pro|institutional)$","title":"Tier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/credits/claim":{"post":{"summary":"Claim Credits","description":"Verify a bulk payment and credit the agent's drawdown balance.","operationId":"claim_credits_v1_credits_claim_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/manifest.json":{"get":{"summary":"Mcp Manifest","description":"Model Context Protocol (MCP) Manifest.\nProvides listing metadata for the public remote discovery server.","operationId":"mcp_manifest_mcp_manifest_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health Check","description":"Health check — free.","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Check Health Get"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}