{"openapi":"3.1.0","info":{"title":"Skopos","description":"Non-custodial, cross-chain crypto copilot — live prices, swap/bridge quotes, token safety, smart-money intel, DeFi yield, prediction markets, DAO treasuries, and Aeon-powered market reads.","version":"1.0.0","x-guidance":"See /openapi.json for the full route list. Quick start: POST /api/price with { symbol: string } for a live spot price.","guidance":"See /openapi.json for the full route list. Quick start: POST /api/price with { symbol: string } for a live spot price."},"servers":[{"url":"https://www.tryskopos.xyz"}],"tags":[{"name":"Flash Order"},{"name":"Market Read"},{"name":"Polymarket"},{"name":"Price"},{"name":"Quote"},{"name":"Risk"},{"name":"Smart Money"},{"name":"Sniper Check"},{"name":"Treasury"},{"name":"Yield"}],"paths":{"/api/market-read":{"post":{"operationId":"market-read","summary":"Aeon-powered market intelligence: defi regime, narratives, trending, top protocols, fear/greed divergence, or x402 ecosystem pulse.","tags":["Market Read"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["defi","narrative","trending","protocols","fear","x402"]}},"required":["kind"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/quote":{"post":{"operationId":"quote","summary":"Swap/bridge route quote — live fees, output amount, and a sign-in link. Execution happens non-custodially in the Skopos app; this endpoint never returns raw calldata.","tags":["Quote"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"originChain":{"type":"string","minLength":1},"destinationChain":{"type":"string","minLength":1},"token":{"type":"string","minLength":1},"amount":{"type":"string","minLength":1},"destinationToken":{"type":"string","minLength":1},"senderAddress":{"type":"string"},"solanaAddress":{"type":"string"}},"required":["originChain","destinationChain","token","amount"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/yield":{"post":{"operationId":"yield","summary":"Live DeFi yield pools for a token, ranked by APY — real fee yield vs. emission-funded, per pool.","tags":["Yield"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","minLength":1,"maxLength":20},"chain":{"type":"string"},"limit":{"default":5,"type":"integer","minimum":1,"maximum":10}},"required":["symbol"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/price":{"post":{"operationId":"price","summary":"Live spot price and 24h change for a crypto token symbol.","tags":["Price"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","minLength":1,"maxLength":20}},"required":["symbol"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/risk":{"post":{"operationId":"risk","summary":"Verdict-first token risk scan — liquidity, volume, honeypot flags, risk score.","tags":["Risk"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":64,"description":"Token symbol or contract address"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/smart-money":{"post":{"operationId":"smart-money","summary":"Named smart-money wallets buying or selling a token, with net flow.","tags":["Smart Money"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":1},"chain":{"type":"string","minLength":1},"symbol":{"type":"string"},"direction":{"default":"BUY","type":"string","enum":["BUY","SELL"]},"timeframe":{"type":"string"}},"required":["address","chain"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/polymarket":{"post":{"operationId":"polymarket","summary":"Live Polymarket odds and volume — by topic, or today's biggest movers if no topic given.","tags":["Polymarket"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topic":{"description":"Omit for today's biggest-volume markets","type":"string","minLength":1,"maxLength":80},"limit":{"default":5,"type":"integer","minimum":1,"maximum":10}}}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/treasury":{"post":{"operationId":"treasury","summary":"Live, multi-chain DAO treasury value and top holdings. Currently supports: uniswap, ens, arbitrum.","tags":["Treasury"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dao":{"type":"string","minLength":1,"maxLength":40}},"required":["dao"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/sniper-check":{"post":{"operationId":"sniper-check","summary":"Holder concentration via Nansen (live, verified). Base sniper detection live via x402 Chain Intel — flags SNIPED on a confirmed bundle (3+ early buyers sharing one tx). RH Chain and Solana still blocked — returns null for those chains. Flags CONCENTRATED when top-10 hold >50% of supply.","tags":["Sniper Check"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tokenAddress":{"type":"string","minLength":1,"maxLength":64,"description":"Token contract address (or mint for Solana)"},"chain":{"type":"string","minLength":1,"maxLength":32,"description":"Chain slug, e.g. \"base\", \"ethereum\", \"solana\""}},"required":["tokenAddress","chain"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/flash-order":{"post":{"operationId":"flash-order","summary":"Advanced-order quote (limit / stop-loss / take-profit / TWAP) via Flash on Robinhood Chain, Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, or Avalanche. qty is the spent asset — USD on a buy, token units on a sell. Returns the priced route and a sign-in link; signing happens non-custodially in the Skopos app, never here.","tags":["Flash Order"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderType":{"type":"string","enum":["limit","stop-loss","take-profit","twap"]},"side":{"type":"string","enum":["buy","sell"]},"token":{"type":"string","minLength":1},"qty":{"type":"string","minLength":1},"priceLevel":{"type":"string"},"durationSeconds":{"type":"integer","minimum":300,"maximum":9007199254740991},"twapBucketCount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"chain":{"type":"string"},"senderAddress":{"type":"string","minLength":1}},"required":["orderType","token","qty","senderAddress"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}}}}