{"openapi":"3.1.0","info":{"title":"Vellum Research","version":"1.0.0","description":"Turns SEC filings into decisions. One paid call returns a structured brief, a change report or an investment-committee scaffold — computed from EDGAR filings, XBRL facts and filing history. USDC on Base, no API keys, no accounts.","x-guidance":"Call any endpoint with a plain GET. You receive HTTP 402 plus a base64 PAYMENT-REQUIRED\nheader describing the price, asset and payTo address.\n\nTo pay: sign an EIP-3009 TransferWithAuthorization for the requested amount in USDC on Base\n(asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, chain id 8453), then repeat the same request\nwith the signed payload base64-encoded in the PAYMENT-SIGNATURE header. The response then carries\na PAYMENT-RESPONSE header with the settlement transaction.\n\nYou need no ETH for gas: the facilitator submits settlement. Data is fetched before settlement,\nso a failing upstream lookup is never charged.\n\nFree routes: /services (machine-readable catalogue), /health, /.well-known/x402.json, /llms.txt."},"servers":[{"url":"https://x402-data-api.x402agent.workers.dev"}],"paths":{"/sec-latest":{"get":{"summary":"vellum-sec-latest","description":"Latest SEC filing lookup by ticker or CIK. Returns form, filing date, accession number and official EDGAR URL for fast agent workflows.","operationId":"vellum_sec_latest","parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker symbol, e.g. MSFT","schema":{"type":"string"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK number (digits only), alternative to ticker","schema":{"type":"string"}},{"name":"form","in":"query","required":false,"description":"Optional filing type, e.g. '10-K', '10-Q' or '8-K'","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/sec-change-signal":{"get":{"summary":"vellum-sec-change-signal","description":"Binary SEC change signal since a date: changed true or false, filing count, form types and the latest official EDGAR filing.","operationId":"vellum_sec_change_signal","parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker symbol, e.g. AAPL","schema":{"type":"string"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK number (digits only), alternative to ticker","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Window start as YYYY-MM-DD","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Lookback in days when since is omitted (1-730, default 7)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/sec-risk-flags":{"get":{"summary":"vellum-sec-risk-flags","description":"Deterministic SEC risk flags: late filing notices, amendments, recent 8-K activity, negative income and liabilities above assets.","operationId":"vellum_sec_risk_flags","parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker symbol, e.g. TSLA","schema":{"type":"string"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK number (digits only), alternative to ticker","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Filing lookback in days (7-730, default 90)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/sec-research":{"get":{"summary":"vellum-sec-research","description":"SEC filing lookup and XBRL facts by ticker or CIK, with form filters, direct EDGAR links and machine-readable JSON.","operationId":"vellum_sec_research","parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker symbol, e.g. AAPL","schema":{"type":"string"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK number (digits only), alternative to ticker","schema":{"type":"string"}},{"name":"forms","in":"query","required":false,"description":"Comma-separated form types to filter, e.g. '10-K,10-Q'","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum filings to return (1-40)","schema":{"type":"string"}},{"name":"facts","in":"query","required":false,"description":"Set to '1' to include the latest XBRL financial facts","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/filing-delta":{"get":{"summary":"vellum-filing-delta","description":"SEC filing delta since a date: new filings, form counts, updated financial facts and change signals for monitoring agents.","operationId":"vellum_filing_delta","parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker symbol, e.g. MSFT","schema":{"type":"string"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK number (digits only), alternative to ticker","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Window start as YYYY-MM-DD","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Window length in days when since is omitted (1-730, default 90)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/filing-brief":{"get":{"summary":"vellum-filing-brief","description":"Cited SEC filing brief with company profile, filing activity, latest financials, period changes, signals and EDGAR source URLs.","operationId":"vellum_filing_brief","parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker symbol, e.g. AAPL","schema":{"type":"string"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK number (digits only), alternative to ticker","schema":{"type":"string"}},{"name":"forms","in":"query","required":false,"description":"Comma-separated form types to count, defaults to the common set","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Number of most recent filings to include (1-40)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.15"},"protocols":[{"x402":{}}]}}},"/ic-memo":{"get":{"summary":"vellum-ic-memo","description":"Investment committee memo from SEC filings: financial trajectory, margins, leverage, ranked risk flags, positives, open questions and sources.","operationId":"vellum_ic_memo","parameters":[{"name":"ticker","in":"query","required":false,"description":"Stock ticker symbol, e.g. NVDA","schema":{"type":"string"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK number (digits only), alternative to ticker","schema":{"type":"string"}},{"name":"form","in":"query","required":false,"description":"Focus on one filing type, e.g. '10-K', 'S-1'. Defaults to the most recent primary filing","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.75"},"protocols":[{"x402":{}}]}}},"/market-data":{"get":{"summary":"vellum-market-data","description":"Free utility: spot prices, market caps and 24h volume for crypto assets","operationId":"vellum_market_data","parameters":[{"name":"ids","in":"query","required":true,"description":"Comma-separated crypto asset ids, e.g. 'bitcoin,ethereum' (1-25)","schema":{"type":"string"}},{"name":"vs","in":"query","required":false,"description":"Quote currency as a 3-letter code, default usd","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/onchain":{"get":{"summary":"vellum-onchain","description":"Free utility: balances, nonces, ERC-20 metadata and transaction receipts on Base or Ethereum","operationId":"vellum_onchain","parameters":[{"name":"address","in":"query","required":true,"description":"EVM address to inspect (0x followed by 40 hex chars)","schema":{"type":"string"}},{"name":"chain","in":"query","required":false,"description":"base or ethereum, default base","schema":{"type":"string"}},{"name":"token","in":"query","required":false,"description":"Optional ERC-20 contract to read the balance of","schema":{"type":"string"}},{"name":"tx","in":"query","required":false,"description":"Optional transaction hash for a receipt lookup","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"base64-encoded signed x402 payment payload"}}}}