{"openapi":"3.1.0","info":{"title":"StockFi","version":"0.1.0","description":"Read-only data checks for Robinhood Chain Stock Tokens, paid per request in USDG over x402. Data checks only. Not investment advice, not a recommendation, and not an offer. Stock Tokens are not intended for U.S. persons and are not available to U.S. persons. StockFi is independent and not affiliated with, endorsed by, or sponsored by Robinhood Markets, Inc. or its affiliates. Responses are canonical JSON (keys sorted); Content-Digest and X-Response-SHA256 carry the SHA-256 of the exact body.","license":{"name":"Apache-2.0"}},"servers":[{"url":"https://stockfi.trade"}],"paths":{"/v1/preflight":{"get":{"summary":"Stock Token Preflight ($0.02; $0.05 when sizeUsdg is sent)","description":"Data checks only. Not investment advice, not a recommendation, and not an offer. Stock Tokens are not intended for U.S. persons. x402Fi is independent and not affiliated with Robinhood Markets, Inc.","parameters":[{"name":"address","in":"query","schema":{"type":"string"},"description":"Stock Token contract on chain 4663. Wins over symbol."},{"name":"symbol","in":"query","schema":{"type":"string"},"description":"Underlying ticker, no X prefix (e.g. AAPL)."},{"name":"side","in":"query","schema":{"type":"string","enum":["buy","sell"],"default":"buy"}},{"name":"sizeUsdg","in":"query","schema":{"type":"number"},"description":"Notional in USDG. Adds a Uniswap route/impact quote (higher price)."},{"name":"venue","in":"query","schema":{"type":"string","enum":["uniswap","rfq","any"],"default":"any"},"description":"Hint only. Never executed."}],"responses":{"200":{"description":"Verdict GO | CAUTION | STOP with reason codes and the underlying facts."},"400":{"description":"Invalid input. Never charged."},"402":{"description":"Payment required: $0.02 USDG via x402 v2 (scheme exact, eip155:4663, payTo 0xc32A9e2f1092F1D57D3267C2E70b80DA9De06D59). The PAYMENT-REQUIRED header carries the requirements (base64 JSON)."},"503":{"description":"Upstream or facilitator unavailable. Not charged; retry."}}}},"/v1/preflight/quote":{"get":{"summary":"Preflight with route quote ($0.05); sizeUsdg required","description":"Data checks only. Not investment advice, not a recommendation, and not an offer. Stock Tokens are not intended for U.S. persons. x402Fi is independent and not affiliated with Robinhood Markets, Inc.","responses":{"200":{"description":"As /v1/preflight, route.included = true."},"400":{"description":"Invalid input. Never charged."},"402":{"description":"Payment required: $0.05 USDG via x402 v2 (scheme exact, eip155:4663, payTo 0xc32A9e2f1092F1D57D3267C2E70b80DA9De06D59). The PAYMENT-REQUIRED header carries the requirements (base64 JSON)."},"503":{"description":"Upstream or facilitator unavailable. Not charged; retry."}}}},"/v1/reopen-risk":{"get":{"summary":"Reopen Risk snapshot ($0.03; $0.10 with report=weekend)","description":"Information only. Not a recommendation to repay, add collateral, or borrow. Not investment advice. Model risk applies. Covers Longbow markets on Robinhood Chain only. Stock Tokens are not intended for U.S. persons. x402Fi is independent and not affiliated with Robinhood Markets, Inc. or Longbow.","parameters":[{"name":"wallet","in":"query","required":true,"schema":{"type":"string"}},{"name":"report","in":"query","schema":{"type":"string","enum":["snapshot","weekend"],"default":"snapshot"}}],"responses":{"200":{"description":"Positions with health-factor scenarios. Empty wallet = 200 with positions: []."},"400":{"description":"Invalid input. Never charged."},"402":{"description":"Payment required: $0.03 USDG via x402 v2 (scheme exact, eip155:4663, payTo 0xc32A9e2f1092F1D57D3267C2E70b80DA9De06D59). The PAYMENT-REQUIRED header carries the requirements (base64 JSON)."},"503":{"description":"Upstream or facilitator unavailable. Not charged; retry."}}}},"/v1/reopen-risk/weekend":{"get":{"summary":"Reopen Risk full weekend report ($0.10)","description":"Information only. Not a recommendation to repay, add collateral, or borrow. Not investment advice. Model risk applies. Covers Longbow markets on Robinhood Chain only. Stock Tokens are not intended for U.S. persons. x402Fi is independent and not affiliated with Robinhood Markets, Inc. or Longbow.","responses":{"200":{"description":"Snapshot plus up-shocks and a short factual summary."},"400":{"description":"Invalid input. Never charged."},"402":{"description":"Payment required: $0.10 USDG via x402 v2 (scheme exact, eip155:4663, payTo 0xc32A9e2f1092F1D57D3267C2E70b80DA9De06D59). The PAYMENT-REQUIRED header carries the requirements (base64 JSON)."},"503":{"description":"Upstream or facilitator unavailable. Not charged; retry."}}}}}}