{"openapi":"3.1.0","info":{"title":"Stock Gate","version":"1.0.0","description":"Read-only Base stock-token preflight. USDC buy quotes, issuer match, NAV freshness and price comparisons. Not safety or trade authorization."},"servers":[{"url":"https://base-token-lens-phs6048.amazonlightsail.com"}],"externalDocs":{"url":"https://base-token-lens-phs6048.amazonlightsail.com/stock-gate/llms.txt"},"paths":{"/api/v1/stocks/catalog":{"get":{"operationId":"listSupportedBaseStockTokens","responses":{"200":{"description":"Supported issuer catalog with exact addresses and reference availability"},"503":{"description":"Issuer catalog unavailable"}}}},"/api/v1/stocks/check":{"get":{"operationId":"checkBaseStockBeforeBuy","summary":"Free stock-token preflight summary","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0xb20000000000000000000078ee7ce2fe4908108c"}},{"name":"amountUsdc","in":"query","required":false,"schema":{"type":"string","default":"100","pattern":"^(?:0|[1-9][0-9]{0,6})(?:\\.[0-9]{1,6})?$"},"description":"Hypothetical USDC buy size, 0.01–1000000, max 6 decimals. Not the API fee."}],"responses":{"200":{"description":"Policy result, not safety or execution approval.","content":{"application/json":{"schema":{"type":"object","required":["schemaVersion","service","chain","address","decision","eligibleForQuote","tradeExecuted","isSafetyGuarantee","order","reasons","checkedAt","expiresAt"],"properties":{"schemaVersion":{"const":"1.0.0"},"service":{"const":"Stock Gate"},"chain":{"type":"object","properties":{"id":{"const":8453}}},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0xb20000000000000000000078ee7ce2fe4908108c"},"decision":{"enum":["pass","review","block"]},"eligibleForQuote":{"type":"boolean"},"tradeExecuted":{"const":false},"isSafetyGuarantee":{"const":false},"checkedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"order":{"type":"object","properties":{"side":{"const":"buy"},"quoteAsset":{"const":"USDC"},"amountUsdc":{"type":"string"}}},"reasons":{"type":"array","items":{"type":"object","required":["code","level"],"properties":{"code":{"type":"string"},"level":{"enum":["review","block"]}}}},"identity":{"type":"object"},"reference":{"type":"object"},"quote":{"type":"object"},"liquidity":{"type":"object"},"marketSchedule":{"type":"object"},"policy":{"type":"object"},"sources":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Invalid input; no provider call or payment."},"429":{"description":"Rate limit; respect Retry-After."},"503":{"description":"Unavailable or insufficient evidence. Fail closed; no settlement on non-2xx."}}}},"/api/v1/stocks/batch":{"get":{"operationId":"checkBaseStockBatch","summary":"Free stock-token preflight, 1-5 tokens","parameters":[{"name":"addresses","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated nonzero Base token contracts, 1-5 inputs."},{"name":"amountUsdc","in":"query","required":false,"schema":{"type":"string","default":"100","pattern":"^(?:0|[1-9][0-9]{0,6})(?:\\.[0-9]{1,6})?$"},"description":"Hypothetical USDC buy size, 0.01–1000000, max 6 decimals. Not the API fee."}],"responses":{"200":{"description":"Ordered summaries and per-item errors. complete=true is not a pass.","content":{"application/json":{"schema":{"type":"object","required":["schemaVersion","service","complete","results"],"properties":{"schemaVersion":{"const":"1.0.0"},"service":{"const":"Stock Gate"},"complete":{"type":"boolean"},"results":{"type":"array","maxItems":5,"items":{"oneOf":[{"type":"object","required":["schemaVersion","service","chain","address","decision","eligibleForQuote","tradeExecuted","isSafetyGuarantee","order","reasons","checkedAt","expiresAt"],"properties":{"schemaVersion":{"const":"1.0.0"},"service":{"const":"Stock Gate"},"chain":{"type":"object","properties":{"id":{"const":8453}}},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0xb20000000000000000000078ee7ce2fe4908108c"},"decision":{"enum":["pass","review","block"]},"eligibleForQuote":{"type":"boolean"},"tradeExecuted":{"const":false},"isSafetyGuarantee":{"const":false},"checkedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"order":{"type":"object","properties":{"side":{"const":"buy"},"quoteAsset":{"const":"USDC"},"amountUsdc":{"type":"string"}}},"reasons":{"type":"array","items":{"type":"object","required":["code","level"],"properties":{"code":{"type":"string"},"level":{"enum":["review","block"]}}}},"identity":{"type":"object"},"reference":{"type":"object"},"quote":{"type":"object"},"liquidity":{"type":"object"},"marketSchedule":{"type":"object"},"policy":{"type":"object"},"sources":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}}}},{"type":"object","required":["address","status","error","eligibleForQuote"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0xb20000000000000000000078ee7ce2fe4908108c"},"status":{"const":"error"},"eligibleForQuote":{"const":false},"error":{"type":"object"}}}]}}}}}}},"400":{"description":"Invalid input; no provider call or payment."},"429":{"description":"Rate limit; respect Retry-After."},"503":{"description":"Unavailable or insufficient evidence. Fail closed; no settlement on non-2xx."}}}},"/api/v1/stocks/report":{"get":{"operationId":"getDetailedBaseStockPreflight","summary":"Detailed Stock Gate report; 0.001 USDC x402 v2","description":"Identity, NAV and a fresh quote preflighted before payment. Review/block are valid paid findings. No trade.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0xb20000000000000000000078ee7ce2fe4908108c"}},{"name":"amountUsdc","in":"query","required":false,"schema":{"type":"string","default":"100","pattern":"^(?:0|[1-9][0-9]{0,6})(?:\\.[0-9]{1,6})?$"},"description":"Hypothetical USDC buy size, 0.01–1000000, max 6 decimals. Not the API fee."}],"responses":{"200":{"description":"Policy result, not safety or execution approval.","content":{"application/json":{"schema":{"type":"object","required":["schemaVersion","service","chain","address","decision","eligibleForQuote","tradeExecuted","isSafetyGuarantee","order","reasons","checkedAt","expiresAt"],"properties":{"schemaVersion":{"const":"1.0.0"},"service":{"const":"Stock Gate"},"chain":{"type":"object","properties":{"id":{"const":8453}}},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0xb20000000000000000000078ee7ce2fe4908108c"},"decision":{"enum":["pass","review","block"]},"eligibleForQuote":{"type":"boolean"},"tradeExecuted":{"const":false},"isSafetyGuarantee":{"const":false},"checkedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"order":{"type":"object","properties":{"side":{"const":"buy"},"quoteAsset":{"const":"USDC"},"amountUsdc":{"type":"string"}}},"reasons":{"type":"array","items":{"type":"object","required":["code","level"],"properties":{"code":{"type":"string"},"level":{"enum":["review","block"]}}}},"identity":{"type":"object"},"reference":{"type":"object"},"quote":{"type":"object"},"liquidity":{"type":"object"},"marketSchedule":{"type":"object"},"policy":{"type":"object"},"sources":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Invalid input; no provider call or payment."},"402":{"description":"Payment required: 1000 atomic USDC, separate from amountUsdc.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"429":{"description":"Rate limit; respect Retry-After."},"503":{"description":"Unavailable or insufficient evidence. Fail closed; no settlement on non-2xx."}}}}}}