{"openapi":"3.1.0","info":{"title":"SmartScan Agents API","version":"1.3.0","description":"Paid quantitative diagnostics for autonomous agents. Every successful result requires exact USDC payment through x402 on Base. Diagnostics only; no execution or financial advice.","contact":{"name":"TKAPI Studio","url":"https://tkapistudio.xyz"}},"servers":[{"url":"https://agent.smart-scan.xyz"}],"tags":[{"name":"Crypto"},{"name":"Equity perpetuals"}],"paths":{"/api/combined":{"get":{"operationId":"runSmartMarketScan","tags":["Crypto"],"summary":"Rank crypto breakout and accumulation matches","description":"Screens the public MEXC USDT universe for liquidity, analyzes selected liquid candidates on 1h and 4h candles, and falls back to Binance if MEXC is unavailable.","parameters":[{"name":"asset","in":"query","required":false,"description":"Optional single-asset diagnostic. Omit to scan the market.","schema":{"type":"string","pattern":"^[A-Z0-9]{2,15}$"}},{"name":"limit","in":"query","required":false,"description":"Maximum liquid candidates receiving candle analysis.","schema":{"type":"integer","minimum":1,"maximum":120,"default":80}},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":15,"default":10}}],"responses":{"200":{"description":"Two ranked result sets and transparent universe/freshness metadata.","content":{"application/json":{"schema":{"type":"object","required":["service","generatedAt","universe","breakout","accumulation"],"properties":{"service":{"const":"combined_scanner"},"generatedAt":{"type":"string","format":"date-time"},"timeframes":{"type":"array","items":{"type":"string"}},"universe":{"type":"object"},"breakout":{"type":"array","items":{"type":"object","required":["asset","pair","source","liquidity","freshness","diagnostic"],"properties":{"asset":{"type":"string","examples":["BTC"]},"pair":{"type":"string","examples":["BTCUSDT"]},"source":{"type":"string","enum":["mexc","binance"]},"liquidity":{"type":"object","properties":{"quoteVolume24h":{"type":"number"},"minimumRequired":{"type":"number"}}},"timeframes":{"type":"object","properties":{"primary":{"const":"4h"},"confirmation":{"const":"1h"}}},"freshness":{"type":"object","properties":{"lastCandleAt":{"type":"string","format":"date-time"},"dataAgeSeconds":{"type":"integer"}}},"confirmation":{"type":["object","null"],"properties":{"state":{"type":"string"},"score":{"type":"integer"}}},"diagnostic":{"type":"object","required":["matched","state","score","price","invalidation"],"additionalProperties":true,"properties":{"matched":{"type":"boolean"},"state":{"type":"string"},"phase":{"type":"string","enum":["recent_breakout","confirmed_breakout","breakout_watch","no_breakout"]},"score":{"type":"integer","minimum":0,"maximum":100},"price":{"type":"number"},"resistance":{"type":"number"},"support":{"type":"number"},"invalidation":{"type":"number","description":"Price level that invalidates the diagnostic thesis."},"evidence":{"type":"array","items":{"type":"string"}}}}}}},"accumulation":{"type":"array","items":{"type":"object","required":["asset","pair","source","liquidity","freshness","diagnostic"],"properties":{"asset":{"type":"string","examples":["BTC"]},"pair":{"type":"string","examples":["BTCUSDT"]},"source":{"type":"string","enum":["mexc","binance"]},"liquidity":{"type":"object","properties":{"quoteVolume24h":{"type":"number"},"minimumRequired":{"type":"number"}}},"timeframes":{"type":"object","properties":{"primary":{"const":"4h"},"confirmation":{"const":"1h"}}},"freshness":{"type":"object","properties":{"lastCandleAt":{"type":"string","format":"date-time"},"dataAgeSeconds":{"type":"integer"}}},"confirmation":{"type":["object","null"],"properties":{"state":{"type":"string"},"score":{"type":"integer"}}},"diagnostic":{"type":"object","required":["matched","state","score","price","invalidation"],"additionalProperties":true,"properties":{"matched":{"type":"boolean"},"state":{"type":"string"},"phase":{"type":"string","enum":["recent_breakout","confirmed_breakout","breakout_watch","no_breakout"]},"score":{"type":"integer","minimum":0,"maximum":100},"price":{"type":"number"},"resistance":{"type":"number"},"support":{"type":"number"},"invalidation":{"type":"number","description":"Price level that invalidates the diagnostic thesis."},"evidence":{"type":"array","items":{"type":"string"}}}}}}},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid query.","content":{"application/json":{"schema":{"type":"object","required":["error","requestId"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"402":{"description":"1.65 USDC x402 payment required on Base.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 payment requirements."}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","required":["error","requestId"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"502":{"description":"Market source or scan failure.","content":{"application/json":{"schema":{"type":"object","required":["error","requestId"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/coinbase-bstocks":{"get":{"operationId":"runCoinbaseBStocksQuant","tags":["Equity perpetuals"],"summary":"Rank Coinbase equity-perpetual basis dislocations","parameters":[{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":19,"default":10}}],"responses":{"200":{"description":"Ranked statistical dislocations after estimated costs.","content":{"application/json":{"schema":{"type":"object","required":["service","generatedAt","universe","results"],"properties":{"service":{"const":"coinbase_bstocks_quant"},"generatedAt":{"type":"string","format":"date-time"},"startedAt":{"type":"string","format":"date-time"},"source":{"type":"string"},"universe":{"type":"object"},"strategy":{"type":"object"},"results":{"type":"array","items":{"type":"object","required":["symbol","signal","score","basis","liquidity","risk","data"],"additionalProperties":true,"properties":{"symbol":{"type":"string","examples":["AAPL-PERP"]},"signal":{"type":"string","enum":["cost_absorbed","watch","confirmed_dislocation","extreme_dislocation"]},"score":{"type":"integer","minimum":0,"maximum":100},"grade":{"type":["string","null"]},"basis":{"type":"object","properties":{"side":{"type":"string"},"grossPct":{"type":"number"},"executablePct":{"type":"number"},"estimatedNetPct":{"type":"number"},"zScore":{"type":["number","null"]},"sampleDays":{"type":"integer"}}},"liquidity":{"type":"object","properties":{"notional24h":{"type":"number"},"openInterest":{"type":["number","null"]},"bookSpreadPct":{"type":["number","null"]}}},"trend":{"type":"object","properties":{"h1":{"type":"string"},"h4":{"type":"string"},"d1":{"type":"string"},"direction":{"type":"string"},"confluence":{"type":"string"}}},"risk":{"type":"object","properties":{"invalidation":{"type":["number","null"]},"invalidationRule":{"type":"string"},"leverageWarning":{"type":"string"}}},"data":{"type":"object","properties":{"source":{"type":"string"},"quotedAt":{"type":["string","null"]}}}}}},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid query.","content":{"application/json":{"schema":{"type":"object","required":["error","requestId"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"402":{"description":"2.50 USDC x402 payment required on Base.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 payment requirements."}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","required":["error","requestId"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"502":{"description":"Market source or scan failure.","content":{"application/json":{"schema":{"type":"object","required":["error","requestId"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}}}}