{"openapi":"3.1.0","info":{"title":"falcon.sol comps","version":"1.0.0","description":"Standardized financials and trading comps from SEC EDGAR, paid per call with x402.","contact":{"name":"falcon.sol","email":"falconsol@mail.grokbot.com","url":"https://x.com/ygfalcon"}},"servers":[{"url":"https://falcon-comps.vercel.app"}],"paths":{"/v1/peers":{"get":{"operationId":"suggestPeers","summary":"Free SIC-based peer suggestions ranked by revenue closeness","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":11}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402 v2)"},"404":{"description":"Unknown ticker (not charged)"}}}},"/v1/preview":{"get":{"operationId":"previewFinancials","summary":"Free latest-FY revenue and net income","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402 v2)"},"404":{"description":"Unknown ticker (not charged)"}}}},"/v1/financials":{"post":{"operationId":"getFinancials","summary":"Standardized financials ($0.015, x402)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"years":{"type":"integer","minimum":1,"maximum":15}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402 v2)"},"404":{"description":"Unknown ticker (not charged)"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.015000"},"protocols":[{"x402":{}}]}}},"/v1/comps":{"post":{"operationId":"getComps","summary":"Trading comps table ($0.05, x402)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"},"maxItems":12},"prices":{"type":"object","additionalProperties":{"type":"number"}}},"required":["tickers"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402 v2)"},"404":{"description":"Unknown ticker (not charged)"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]}}},"/v1/credit":{"post":{"operationId":"getCredit","summary":"Lev-fin credit comps: leverage, coverage, debt capacity, rated structures, memo ($0.24, x402)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"},"maxItems":12},"prices":{"type":"object","additionalProperties":{"type":"number"}},"assumptions":{"type":"object","additionalProperties":{"type":"number"}}},"required":["tickers"]}}}},"responses":{"200":{"description":"JSON"},"402":{"description":"x402 payment required"}}}},"/v1/gpu-comps":{"post":{"operationId":"getGpuComps","summary":"GPU $/GPU-hr comps from provider public pricing pages, with source URLs and fetched_at ($0.04, x402)","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"gpus":{"type":"array","items":{"type":"string"},"maxItems":12,"example":["h100","h200"]},"tiers":{"type":"array","items":{"type":"string","enum":["community_cloud","secure_cloud","serverless","on_demand_instance","cluster_committed"]}},"target_usd_per_gpu_hr":{"type":"number"}}}}}},"responses":{"200":{"description":"JSON"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"x402 payment required"},"502":{"description":"Price sources unavailable (not charged)"}}}},"/v1/lbo":{"post":{"operationId":"getLbo","summary":"LBO snapshot: sources & uses, 3 structures, IRR/MOIC, IRR grid, memo ($4.49, x402)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"interest_basis":{"type":"string","enum":["beginning","average"]},"peers":{"type":"array","items":{"type":"string"},"maxItems":8},"exit_multiple":{"type":"number"},"price":{"type":"number"},"assumptions":{"type":"object","additionalProperties":{"type":"number"}}},"required":["ticker"]}}}},"responses":{"200":{"description":"JSON"},"402":{"description":"x402 payment required"},"422":{"description":"Not applicable (financials / negative EBITDA)"}}}},"/accuracy":{"get":{"operationId":"accuracy","summary":"Published accuracy results","responses":{"200":{"description":"JSON"}}}}}}