{"openapi":"3.1.0","info":{"title":"Blocksize Capital Agentic Data Economy","description":"\nInstitutional-grade financial data gateway for autonomous AI agents.\nSupports x402 real-time payment settlement, bulk wallet credits, and a public\nremote MCP discovery surface for directory listings and client onboarding.\n\n### Public Integration Surfaces\n- **Developer Portal**: [Homepage](https://agentic-payments-production.up.railway.app/)\n- **Remote MCP URL**: [Streamable HTTP](https://agentic-payments-production.up.railway.app/mcp/server/)\n- **MCP Manifest**: [Listing metadata](https://agentic-payments-production.up.railway.app/mcp/manifest.json)\n- **OpenAPI**: [JSON schema](https://agentic-payments-production.up.railway.app/openapi.json)\n- **Swagger UI**: [Interactive docs](https://agentic-payments-production.up.railway.app/docs)\n- **Quickstart**: [Remote MCP install guide](https://agentic-payments-production.up.railway.app/quickstart/remote-mcp)\n- **Prompt Examples**: [Example prompts](https://agentic-payments-production.up.railway.app/prompt-examples)\n- **Privacy Policy**: [Privacy](https://agentic-payments-production.up.railway.app/privacy)\n- **Support**: [Contact and troubleshooting](https://agentic-payments-production.up.railway.app/support)\n    ","version":"0.6.0"},"paths":{"/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 CAIP-compliant requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded JSON array of payment requirements (network, recipient, amount).","schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bidask/{pair}":{"get":{"summary":"Get Bidask","description":"Get bid/ask snapshot for a crypto pair. Cost: $0.002–$0.004 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 CAIP-compliant requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded JSON array of payment requirements (network, recipient, amount).","schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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 CAIP-compliant requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded JSON array of payment requirements (network, recipient, amount).","schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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 CAIP-compliant requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded JSON array of payment requirements (network, recipient, amount).","schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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 CAIP-compliant requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 encoded JSON array of payment requirements (network, recipient, amount).","schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"Payment Required","message":"This endpoint requires a payment of $0.002 USDC.","price_usdc":"0.002","networks":[{"name":"Solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},{"name":"Base","caip2":"eip155:8453"}]}}}},"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","description":"Search query","title":"Q"},"description":"Search query"},{"name":"asset_class","in":"query","required":false,"schema":{"type":"string","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"}}}}