{"openapi":"3.1.0","info":{"title":"supership","description":"supership is the stock and financial-data layer for AI agents on x402: fresh SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4) for any US public company at $0.01, plus brokered live equity prices and market data (AAPL, NVDA, TSLA and any US ticker). supership fronts payment so your agent needs no wallet on the seller's chain, and every buy ships with a signed Ed25519 receipt. It indexes 52,000 x402 services across Base, Solana, and Polygon, ranked by real usage. supership brokers and witnesses market data; it is not a price oracle.","version":"2.1.0","contact":{"name":"Crest Deployment Systems","url":"https://crestsystems.ai"},"x-guidance":"supership is the stock and financial-data front door for the x402 economy. STOCK and SEC DATA: GET /edgar?ticker=AAPL (SEC filings 10-K/10-Q/8-K/Form 4 for any US public company, $0.01); GET /manifest?need=stock+prices to find brokered live equity-price and market-data sources, then GET /procure to buy them with payment fronted (no seller-chain wallet needed); or GET /v2/stocks/brief?ticker=AAPL for one call returning fresh filings + a best-effort live price + a source trust verdict in ONE signed receipt ($0.08). FREE: search the 52,000-service index with GET /manifest?need=<task> (ranked by real distinct payers); browse GET /catalog; try a source free with GET /sample?url=<url>; build a multi-source packet with GET /bundle?preset=market_context. TRUST: GET /vouch?url= (signed trust verdict on any x402 service from the real on-chain payer graph, $0.02), GET /check, GET /passport; every paid result carries a signed receipt verifiable at GET /api/pubkey. ALSO: POST /scan/quick|full|deep (code security audit, $1/$5/$15). supership fronts every payment, so you need no wallet on the seller chain. It brokers and witnesses market data; it does not run a price oracle. No API keys, no signup."},"servers":[{"url":"https://supership.crestsystems.ai"}],"paths":{"/manifest":{"get":{"summary":"Find stock prices, equity and market data, SEC filings, earnings, and any other source in the x402 economy (52,000 services), ranked by distinct payers (real adoption), not call counts. FREE.","security":[],"parameters":[{"name":"need","in":"query","required":true,"schema":{"type":"string"},"description":"Plain-language description of the data or service you need"}],"responses":{"200":{"description":"Ranked sources with payers, price, network, and procure links"}}}},"/bundle":{"get":{"summary":"Buy a multi-source decision packet in one call: onchain state + crypto news/sentiment + market data, returned with ONE Ed25519 settlement-anchored receipt across all sources. supership fronts each payment; you need no wallet on any seller chain. FREE (capped).","security":[],"parameters":[{"name":"preset","in":"query","schema":{"type":"string","enum":["market_context"]},"description":"A named bundle, e.g. market_context"},{"name":"url","in":"query","schema":{"type":"array","items":{"type":"string"}},"description":"Or pass >=2 source URLs (repeat url=, or comma-separate)"}],"responses":{"200":{"description":"All sources delivered + one supership.bundle.v1 receipt"}}}},"/catalog":{"get":{"summary":"Browse the curated catalog of procurable sources. FREE.","security":[],"parameters":[{"name":"contains","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Catalog of procurable sources with URL, price, network"}}}},"/sample":{"get":{"summary":"Procure one source on the house, the free first run. supership fronts payment; no wallet needed on the seller chain. FREE (capped).","security":[],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Delivered goods + on-chain settlement reference + signed receipt"}}}},"/procure":{"get":{"summary":"Buy any x402 source -- live stock prices, market data, financial feeds, or anything else -- across any substrate; supership fronts payment so your agent needs no seller-chain wallet, and delivers a signed receipt. PAID $0.05.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Delivered goods + settlement reference + signed receipt"},"402":{"description":"Payment Required"}}}},"/check":{"get":{"summary":"Trust check with transparent scoring methodology. FREE.","security":[],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Trust assessment with methodology"}}}},"/receipt":{"post":{"summary":"Report outcome after calling an x402 service. FREE.","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"service_url":{"type":"string","description":"URL of the service called"},"outcome":{"type":"string","enum":["complete","partial","failed","timeout","refused","invalid_payment","invalid_response","unsafe"]},"latency_ms":{"type":"integer"},"amount_paid_usd":{"type":"number"},"quality_rating":{"type":"integer","minimum":1,"maximum":5},"route_id":{"type":"string"},"tx_hash":{"type":"string"}},"required":["service_url","outcome"]}}}},"responses":{"200":{"description":"Receipt accepted with classification and SHA-256 hash"}}}},"/passport":{"get":{"summary":"Service identity with computed trust score. FREE.","security":[],"parameters":[{"name":"url","in":"query","schema":{"type":"string"}},{"name":"host","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Service passport with trust methodology"}}}},"/network":{"get":{"summary":"Live network stats with anti-Sybil and data policy. FREE.","security":[],"responses":{"200":{"description":"Network health, data policy, anti-Sybil info"}}}},"/v2/route":{"get":{"summary":"Receipt-powered service recommendations. PAID $0.001.","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"network","in":"query","schema":{"type":"string"}},{"name":"max_price","in":"query","schema":{"type":"number"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Ranked recommendations with trust labels"},"402":{"description":"Payment Required"}}}},"/v2/receipts/preview":{"get":{"summary":"Receipt aggregates for a service. FREE.","security":[],"parameters":[{"name":"service_url","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Receipt summary"}}}},"/edgar/preview":{"get":{"summary":"SEC EDGAR filings preview, latest filings for a ticker. FREE.","security":[],"parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Recent filings preview"}}}},"/scan/free":{"post":{"summary":"Free code scan: score + grade. FREE.","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"object"}},"required":["files"]}}}},"responses":{"200":{"description":"Scan score and grade"}}}},"/edgar":{"get":{"summary":"Stock and financial data: fresh SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4) with document URLs for any US public company (AAPL, NVDA, TSLA, etc.), straight from data.sec.gov. PAID $0.01.","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Verified recent filings with document URLs"},"402":{"description":"Payment Required"}}}},"/vouch":{"get":{"summary":"Signed trust verdict on any x402 service from the real on-chain payer graph (wash-resistant: scored on distinct payers). The credit check before paying an unknown service; the verdict is a verifiable Ed25519 attestation you keep as provenance. PAID $0.02.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"A signed supership.vouch.v1 trust verdict"},"402":{"description":"Payment Required"}}}},"/v2/stocks/brief":{"get":{"summary":"One-call stock data for any US public company: fresh SEC filings (10-K/10-Q/8-K/Form 4) + a best-effort live equity price (brokered from an x402 source) + a source trust verdict, all in ONE signed receipt. Tickers like AAPL, NVDA, TSLA. supership brokers and witnesses; it is not a price oracle. PAID $0.08.","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string"},"description":"US ticker, e.g. AAPL, NVDA, TSLA"},{"name":"include_price","in":"query","schema":{"type":"boolean"},"description":"default true; false for filings + trust only"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","description":"US ticker, e.g. AAPL, NVDA, TSLA"}},"required":["ticker"]}}}},"responses":{"200":{"description":"SEC filings + live price + source trust verdict + one signed receipt","content":{"application/json":{"schema":{"type":"object","properties":{"receipt":{"type":"object","description":"signed supership.bundle.v1 over the whole packet (the product); verify at /api/pubkey"},"verify":{"type":"string"},"ticker":{"type":"string"},"sec_filings":{"type":"object"},"live_price":{"type":"object"},"source_trust":{"type":"object"}}}}}},"402":{"description":"Payment Required"}}}},"/scan/quick":{"post":{"summary":"Quick code security scan. PAID $1.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"object"}},"required":["files"]}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Scan results"},"402":{"description":"Payment Required"}}}},"/scan/full":{"post":{"summary":"Full code security audit. PAID $5.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"object"}},"required":["files"]}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"5.00"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Complete audit"},"402":{"description":"Payment Required"}}}},"/scan/deep":{"post":{"summary":"Deep AI-powered security review. PAID $15.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"object"}},"required":["files"]}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"15.00"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"AI-powered review"},"402":{"description":"Payment Required"}}}},"/v2/label":{"post":{"summary":"Signed quality labels for any code artifact: ship_ready, do_not_ship, review_required, etc. PAID $0.001.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"object","description":"Map of filepath to content"}},"required":["files"]}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Signed quality labels with confidence debt"},"402":{"description":"Payment Required"}}}},"/v2/ship":{"post":{"summary":"Signed deployment readiness manifest: decision, blockers, labels, and confidence debt. PAID $0.01.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"object"}},"required":["files"]}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Signed deploy manifest with blockers"},"402":{"description":"Payment Required"}}}},"/v2/refuse":{"post":{"summary":"Structured refusal with taxonomy: what is wrong, how severe, how to fix. PAID $0.25.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"object"}},"required":["files"]}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Structured refusal with remediation taxonomy"},"402":{"description":"Payment Required"}}}}}}