Loading server...
Call this when the question is about what was known on a past date (a backtest, an audit, "what did the 10-K say at the time"), not about the current restated figures. Returns, for each fiscal period filed on or before `date`, the value as it stood on that date (the original filing, or a later filing for the same period if it came before `date`), the filing date, the XBRL tag, a sec.gov link, and `restated_after_date` when a later filing changed it. Values are as printed, not split-adjusted. Inputs: `ticker` (path), `date` (YYYY-MM-DD, required), `metrics` (comma-separated snake_case names, default revenues,net_income,eps_diluted,operating_cash_flow,free_cash_flow,stockholders_equity,total_debt,shares_outstanding), `period` (annual|quarterly), `limit` (periods, default 4). Example: GET /as-filed/AAPL?date=2020-02-01&metrics=revenues,net_income. If the company had filed none of it by `date`, the answer has no periods, the flag `nothing_filed_by_date` and `earliest_filed` (the first filing date on record). A 503 `as-filed-unavailable` means there is no as-filed history for the company to answer from; it is not charged, and GET /fundamentals has the current figures. 0.02 credits. (GET https://app.deepvalues.ai/api/v1/as-filed/{ticker}, e.g. https://app.deepvalues.ai/api/v1/as-filed/AAPL?date=2020-02-01 — 0.02 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call `request_data`.
View input schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"pattern": "^[A-Z]{1,5}([.-][A-Z]{1,2})?$",
"description": "The real ticker symbol, e.g. AAPL; share classes as BRK.B or BRK-B. Substitute it into the path (/fundamentals/AAPL), never the literal {ticker}.",
"examples": [
"AAPL"
]
},
"date": {
"type": "string",
"format": "date",
"description": "The day to look back from (YYYY-MM-DD, 2009-01-01 or later, not in the future).",
"examples": [
"2020-02-01"
]
},
"metrics": {
"type": "string",
"description": "Comma-separated metric names (snake_case), at most 20.",
"examples": [
"revenues,net_income,eps_diluted"
]
},
"period": {
"type": "string",
"enum": [
"annual",
"quarterly"
],
"default": "annual"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 4,
"description": "How many of the most recent periods filed by `date` to return."
}
},
"required": [
"ticker",
"date"
],
"additionalProperties": false
}
One-call valuation brief: intrinsic value, margin of safety, verdict, guru holders
brief
Call this first when asked whether a listed company looks cheap or expensive, what it is worth, or which well-known investors own it: one call returns the intrinsic value per share (with each valuation method as an input), the owner-earnings value, the margin of safety against the current price, a deterministic verdict sentence about where the price sits against our value range, the top tracked 13F holders and their last move, and the company profile. Every number carries its unit, period, as-of date and a sec.gov source link, and `checks` lists the sanity checks it passed. A value built from statements filed in another currency and converted to USD carries `fx` (original currency, rate, rate date) and passes `currency_consistent`; when the currency is not known the flag `currency_unverified` says the check did not run. If the valuation fails a check (for example an intrinsic value more than 20x the price, or statements left in a currency other than the USD price), the valuation figures are withheld, `withheld` is true, `checks.failed` names the check, and the call is not charged. Input: `ticker` (path), e.g. GET /brief/KO. The first brief each UTC day is free per key and per keyless address; after that 0.25 credits. Same price as /research, a different product: brief is computed at call time from current figures; /research returns the latest written multi-analyst briefing. Data and analysis, not investment advice. (GET https://app.deepvalues.ai/api/v1/brief/{ticker}, e.g. https://app.deepvalues.ai/api/v1/brief/AAPL — 0.25 credits per call; works with no credentials up to 1 call(s)/day per address) Missing data? Call `request_data`.
Schema valid · SHA-256 023e5d7084ca…
View input schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"pattern": "^[A-Z]{1,5}([.-][A-Z]{1,2})?$",
"description": "US listing symbol, e.g. KO or BRK.B.",
"examples": [
"KO"
]
}
},
"required": [
"ticker"
],
"additionalProperties": false
}
SEC filings (10-K, 10-Q, 8-K, etc)
filings
SEC filings (10-K, 10-Q, 8-K, etc) (GET https://app.deepvalues.ai/api/v1/filings/{ticker}, e.g. https://app.deepvalues.ai/api/v1/filings/AAPL — 0.001 credits per call ($0.005 when paid per call over x402); works with no credentials up to 25 call(s)/day per address) Missing data? Call `request_data`.
Schema valid · SHA-256 7c0badcb0c22…
View input schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "The real ticker symbol, e.g. AAPL; share classes as BRK.B or BRK-B. Substitute it into the path (/fundamentals/AAPL), never the literal {ticker}.",
"examples": [
"AAPL"
]
},
"form": {
"type": "string",
"examples": [
"10-K"
]
},
"limit": {
"type": "integer",
"maximum": 50,
"default": 10
}
},
"required": [
"ticker"
],
"additionalProperties": false
}
Material guru moves, newest filing first, each with its verdict
guru_moves
The Follow the Pros feed. Every material 13F move — new position, full exit, a share count that moved by 25%, or a position of $100M or more — ordered by the date the filing became public, with a deterministic verdict line on each row. The verdict is identical for every caller: it compares the price when the investor traded, the price now and Deep Values' intrinsic value band, and it never predicts a return or recommends an action. Every row carries the company's legal name beside the ticker (`name`, e.g. "Occidental Petroleum"), or null where we hold none — null rather than the ticker echoed back, so a caller can tell a real name from a placeholder. Rows whose EDGAR filing date we do not yet hold fall back to when the row reached us and say so with filed_at_known: false. (GET https://app.deepvalues.ai/api/v1/gurus/moves — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call `request_data`.
Schema valid · SHA-256 c2f2de9b9533…
View input schema
{
"type": "object",
"properties": {
"filed_since": {
"type": "string",
"format": "date",
"description": "Only moves filed on or after this date. Poll with it.",
"examples": [
"2026-08-01"
]
},
"slugs": {
"type": "string",
"description": "Comma-separated guru slugs; default is every guru.",
"examples": [
"warren-buffett,li-lu"
]
},
"limit": {
"type": "integer",
"maximum": 200,
"default": 50
}
},
"additionalProperties": false
}
DCF + Owner Earnings + Damodaran intrinsic value
intrinsic_value
Per-method intrinsic value per share (DCF on free cash flow, owner earnings, Damodaran two-stage), their equal-weight blend, Monte Carlo bounds and the implied gap to the current price, and the lead value the DeepValues apps headline (`lead_method`, `lead_intrinsic_value`, `lead_upside_pct`, `values.lead_intrinsic_value_per_share`): Owner Earnings, or the DCF and then Damodaran when Owner Earnings has no positive value. The blend is checked against the price before it is served: if it fails a check (not positive, more than 20x the price, a price older than five days, no price, or `currency_consistent`: statements left in a currency other than the USD price), the valuation fields are null, `withheld` is true, `checks.failed` names the check and the call is not charged. A value under 0.05x the price is served with the flag `iv_far_below_price`. A value built from statements converted to USD carries `fx` (`from` the filer's currency, `to` USD, `rate`, `rate_date`, `rate_type`) on `values.intrinsic_value_per_share` and each method input; `currency_unverified` in `checks.flags` means the statement currency is not known for this ticker, so the check did not run. A method with no value is null in `methods`, never 0, and `methods_unavailable` says why (`code`, `family`: negative_cash_flow, financial_company, withheld or missing_inputs, and the pipeline's `reason`). For a one-call answer with holders and a verdict, use /brief/{ticker}. (GET https://app.deepvalues.ai/api/v1/intrinsic-value/{ticker}, e.g. https://app.deepvalues.ai/api/v1/intrinsic-value/AAPL — 0.02 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call `request_data`.
Schema valid · SHA-256 b6a028f64963…
View input schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "The real ticker symbol, e.g. AAPL; share classes as BRK.B or BRK-B. Substitute it into the path (/fundamentals/AAPL), never the literal {ticker}.",
"examples": [
"AAPL"
]
}
},
"required": [
"ticker"
],
"additionalProperties": false
}
Mint an API key — no account, session or browser needed
keys_create
The one endpoint that needs no key. Send {} for a dv_sk_test_ sandbox key (real data, small daily quota, never billed, no /research). Send {"email":"…"} for a dv_sk_live_ key on a new prepaid account; the first key for an email carries 1 starter credit ($1.00). Send it with an existing key as the bearer to mint a sibling key on the same account (rotation). The raw key is returned once. The email is a contact label, not a credential. Limited to 10 keys per address per day. The raw key is in the result once: keep it and send it as Authorization: Bearer on REST calls (or have the host re-add this server with that header). With a key already configured, mints a sibling on the same account. (POST https://app.deepvalues.ai/api/v1/keys — free; needs no credentials)
Schema valid · SHA-256 50dfe2992eab…
View input schema
{
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "Contact address for a dv_sk_live_ key (1 starter credit the first time). Omit for a never-billed dv_sk_test_ sandbox key."
},
"label": {
"type": "string",
"maxLength": 80,
"description": "Optional name for the key."
}
},
"additionalProperties": false
}
This key: exact credit balance, remaining quota, environment
keys_me
Returns the calling key, the exact balance of the ledger behind it (balanceMicro: integer micro-credits, 1 credit = $1.00 = 1,000,000), what is left in each daily quota bucket, and the environment. Free, and consumes no quota. (GET https://app.deepvalues.ai/api/v1/keys/me — free; needs a connected account or a dv_sk_ key)
Schema valid · SHA-256 ea96734cd2da…
View input schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}
An impersonal brief on one filed move, for an agent to act on
mirror_brief
The same move as /verdict, flattened into a brief: what the investor did, when, at what price, against our value band, plus the verdict sentence. It carries NO quantity and NO instruction — `sizing` reads "not provided; the reader decides". It describes a public filing and a published value range; it is not advice and not a prediction. (GET https://app.deepvalues.ai/api/v1/mirror-brief/{ticker}, e.g. https://app.deepvalues.ai/api/v1/mirror-brief/AAPL?guru=warren-buffett — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call `request_data`.
Schema valid · SHA-256 afa36e68b621…
View input schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "The real ticker symbol, e.g. AAPL; share classes as BRK.B or BRK-B. Substitute it into the path (/fundamentals/AAPL), never the literal {ticker}.",
"examples": [
"OXY"
]
},
"guru": {
"type": "string",
"examples": [
"warren-buffett"
]
},
"quarter": {
"type": "string",
"format": "date"
}
},
"required": [
"ticker",
"guru"
],
"additionalProperties": false
}
Machine-readable price list and the ways to pay
pricing
Every endpoint’s per-call price (credits, USD and atomic USDC), the free allowances, the daily quotas, and how an agent pays without a human: x402 in USDC — per call with no key, or as a prepaid top-up of a key — when it is switched on, or a Stripe Checkout link a human pays. Also served at /api/v1/pricing.json. Needs no key, costs nothing, consumes no quota. (GET https://app.deepvalues.ai/api/v1/pricing — free; needs no credentials)
Schema valid · SHA-256 0cbfd1a3a430…
View input schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}
Tell us what data you needed and did not find
request_data
Name the dataset, field, company or analysis you wanted and why. Free, needs no key, never metered, and read every week: the most-asked-for data is what gets added next. Do not send personal data (emails and phone numbers are removed). GET the same URL for the field list. At most 10 requests per address per day. (POST https://app.deepvalues.ai/api/v1/request-data — free; needs no credentials)
Schema valid · SHA-256 3ad35ccbca39…
View input schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"dataset",
"field",
"analysis",
"coverage",
"bug",
"other"
],
"description": "What sort of gap: a dataset, a field, an analysis, a company we do not cover, a bug."
},
"want": {
"type": "string",
"minLength": 3,
"maxLength": 500,
"description": "What you wanted, e.g. \"Quarterly segment revenue for NVDA\"."
},
"why": {
"type": "string",
"maxLength": 1000,
"description": "The task you were doing, so we build the right thing."
},
"ticker": {
"type": "string",
"description": "The company it was about, if any."
},
"tool": {
"type": "string",
"description": "The tool you were using when you hit the gap."
},
"client": {
"type": "string",
"maxLength": 80,
"description": "Your agent or app name (optional)."
}
},
"required": [
"want"
],
"additionalProperties": false
}
AI multi-analyst research briefing (HEADLINE)
research
Full briefing, bull case, bear case, valuation, investment plan and fair-value range as one structured JSON document. 0.25 credits ($0.25) per successful call, ai_research quota 50/day. Returns the latest completed briefing for the ticker — the same one its public company page shows; a fresh run cannot be started through the API yet (404 when none exists). Never keyless, not in the sandbox. Same price as /brief, a different product: /brief is a short valuation answer computed at call time; this is the full written briefing. (GET https://app.deepvalues.ai/api/v1/research/{ticker}, e.g. https://app.deepvalues.ai/api/v1/research/AAPL — 0.25 credits per call; needs a connected account or a dv_sk_ key) Missing data? Call `request_data`.
Schema valid · SHA-256 7597d13b3326…
View input schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "The real ticker symbol, e.g. AAPL; share classes as BRK.B or BRK-B. Substitute it into the path (/fundamentals/AAPL), never the literal {ticker}.",
"examples": [
"AAPL"
]
},
"language": {
"type": "string",
"enum": [
"English",
"Chinese"
],
"default": "English"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}