{"openapi":"3.1.0","info":{"title":"Crypto Shark Bazaar","version":"2.2.0","description":"Low-cost x402 blockchain primitives, market intelligence, and AI utilities for autonomous agents"},"servers":[{"url":"https://cryptoshark.duckdns.org"}],"paths":{"/reports/market":{"get":{"summary":"Market snapshot for a supported crypto asset","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","example":"bitcoin"}}],"responses":{"200":{"description":"Market snapshot"},"402":{"description":"USDC payment required"}},"x-payment-info":{"price":"$0.005","network":"eip155:8453"}}},"/reports/stablecoin-yields":{"get":{"summary":"Ranked stablecoin yield opportunities with liquidity filters","responses":{"200":{"description":"Yield comparison"},"402":{"description":"USDC payment required"}},"x-payment-info":{"price":"$0.02","network":"eip155:8453"}}},"/reports/etc-market":{"get":{"summary":"Ethereum Classic market pulse","responses":{"200":{"description":"ETC market data"},"402":{"description":"USDC payment required"}},"x-payment-info":{"price":"$0.01","network":"eip155:8453"}}},"/chain/block-number":{"get":{"tags":["Blockchain data"],"summary":"Block number on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":false,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":false,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Block number"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.001","network":"eip155:8453","asset":"USDC"}}},"/chain/gas-price":{"get":{"tags":["Blockchain data"],"summary":"Current gas price on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":false,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":false,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Current gas price"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.001","network":"eip155:8453","asset":"USDC"}}},"/chain/finalized-block":{"get":{"tags":["Blockchain data"],"summary":"Latest finalized block on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":false,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":false,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Latest finalized block"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.001","network":"eip155:8453","asset":"USDC"}}},"/chain/transaction-count":{"get":{"tags":["Blockchain data"],"summary":"Address transaction count on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":true,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":false,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Address transaction count"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.001","network":"eip155:8453","asset":"USDC"}}},"/chain/confirmation-status":{"get":{"tags":["Blockchain data"],"summary":"Transaction confirmation status on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":false,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":true,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Transaction confirmation status"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.001","network":"eip155:8453","asset":"USDC"}}},"/chain/token-balance":{"get":{"tags":["Blockchain data"],"summary":"ERC-20 token balance on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":true,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":false,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":true,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"ERC-20 token balance"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.001","network":"eip155:8453","asset":"USDC"}}},"/chain/token-transfers":{"get":{"tags":["Blockchain data"],"summary":"Recent ERC-20 transfers on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":true,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":false,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":true,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Recent ERC-20 transfers"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.001","network":"eip155:8453","asset":"USDC"}}},"/chain/native-balance":{"get":{"tags":["Blockchain data"],"summary":"Native balance on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":true,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":false,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Native balance"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.003","network":"eip155:8453","asset":"USDC"}}},"/chain/transaction":{"get":{"tags":["Blockchain data"],"summary":"Transaction lookup on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":false,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":true,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Transaction lookup"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.008","network":"eip155:8453","asset":"USDC"}}},"/chain/receipt":{"get":{"tags":["Blockchain data"],"summary":"Transaction receipt on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":false,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":true,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Transaction receipt"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.005","network":"eip155:8453","asset":"USDC"}}},"/chain/code":{"get":{"tags":["Blockchain data"],"summary":"Contract code on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":true,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":false,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Contract code"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.003","network":"eip155:8453","asset":"USDC"}}},"/chain/network-info":{"get":{"tags":["Blockchain data"],"summary":"Network status on Base, Ethereum, or Ethereum Classic","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["base","ethereum","etc"],"default":"base"}},{"name":"address","in":"query","required":false,"schema":{"type":"string","example":"0x83a18b50f9b894CA5BA28Ad54585d9c80058FbcD"}},{"name":"hash","in":"query","required":false,"schema":{"type":"string","example":"0x4fae5d659930d8898470215ff1816d8aa43d5155e7f3edba696e7c6862dbb66e"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"blocks","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Network status"},"400":{"description":"Invalid input"},"402":{"description":"USDC payment required"},"502":{"description":"Upstream RPC unavailable"}},"x-payment-info":{"price":"$0.001","network":"eip155:8453","asset":"USDC"}}},"/ai/grammar":{"post":{"tags":["AI utilities"],"summary":"Grammar Review","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"string","maxLength":6000}}},"example":{"input":"Review this text or request."}}}},"responses":{"200":{"description":"Grammar Review result"},"402":{"description":"USDC payment required"},"503":{"description":"AI service unavailable"}},"x-payment-info":{"price":"$0.03","network":"eip155:8453","asset":"USDC"}}},"/ai/tutor":{"post":{"tags":["AI utilities"],"summary":"Writing Tutor","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"string","maxLength":6000}}},"example":{"input":"Review this text or request."}}}},"responses":{"200":{"description":"Writing Tutor result"},"402":{"description":"USDC payment required"},"503":{"description":"AI service unavailable"}},"x-payment-info":{"price":"$0.05","network":"eip155:8453","asset":"USDC"}}},"/ai/code":{"post":{"tags":["AI utilities"],"summary":"Code on Demand","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"string","maxLength":8000}}},"example":{"input":"Review this text or request."}}}},"responses":{"200":{"description":"Code on Demand result"},"402":{"description":"USDC payment required"},"503":{"description":"AI service unavailable"}},"x-payment-info":{"price":"$0.10","network":"eip155:8453","asset":"USDC"}}}}}