{"openapi":"3.1.0","info":{"title":"Blocksize Real Time Market Data","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/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/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/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"}}}}