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 s
Показать схему аргументов
{
"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
}
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)
Показать схему аргументов
{
"type": "object",
"properties": [],
"additionalProperties": false
}
credits_packs
Lists the prepaid credit packs this key can buy (1 credit = $1.00). Free. (GET https://app.deepvalues.ai/api/v1/credits/checkout — free; needs a connected account or a dv sk key)
Показать схему аргументов
{
"type": "object",
"properties": [],
"additionalProperties": false
}
credits_checkout
Creates a one-time Stripe Checkout Session for a credit pack, bound to the calling live key’s account. When the payment completes the credits land on that balance; poll GET /keys/me. This is what a 402 topUp.checkoutEndpoint points at. Free, consumes no quota. (POST https://app.deepvalues.ai/api/v1/credits/checkout — free; needs a connected account or a dv sk key)
Показать схему аргументов
{
"type": "object",
"required": [
"pack"
],
"properties": {
"pack": {
"type": "string",
"description": "Credit pack to buy, e.g. \"1000\". The `credits_packs` tool lists the packs on sale."
}
},
"additionalProperties": false
}
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)
Показать схему аргументов
{
"type": "object",
"properties": [],
"additionalProperties": false
}
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)
Показать схему аргументов
{
"type": "object",
"required": [
"want"
],
"properties": {
"why": {
"type": "string",
"maxLength": 1000,
"description": "The task you were doing, so we build the right thing."
},
"kind": {
"enum": [
"dataset",
"field",
"analysis",
"coverage",
"bug",
"other"
],
"type": "string",
"description": "What sort of gap: a dataset, a field, an analysis, a company we do not cover, a bug."
},
"tool": {
"type": "string",
"description": "The tool you were using when you hit the gap."
},
"want": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "What you wanted, e.g. \"Quarterly segment revenue for NVDA\"."
},
"client": {
"type": "string",
"maxLength": 80,
"description": "Your agent or app name (optional)."
},
"ticker": {
"type": "string",
"description": "The company it was about, if any."
}
},
"additionalProperties": false
}
account
Returns the calling key, its scopes, environment, and today's usage across all 3 buckets. Self-billing: counts as 1 metadata call. (GET https://app.deepvalues.ai/api/v1/account — free; needs a connected account or a dv sk key)
Показать схему аргументов
{
"type": "object",
"properties": [],
"additionalProperties": false
}
ai_context
Returns a system prompt + structured context block, scoped to one ticker. Drop it into OpenAI/Anthropic/any LLM SDK to ground your chatbot in current Deep Values data without months of plumbing. Bills 3 metadata units. (GET https://app.deepvalues.ai/api/v1/ai-context/{ticker}, e.g. https://app.deepvalues.ai/api/v1/ai-context/AAPL — 0.02 credits per call; works with no credentials up to 1 call(s)/day per address) Missing data? Call request data .
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"examples": [
"AAPL"
],
"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}."
},
"token_budget": {
"type": "integer",
"default": 6000,
"maximum": 16000,
"minimum": 1000
}
},
"additionalProperties": false
}
research
Full briefing, bull case, bear case, valuation, investment plan and intrinsic-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. htt
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"examples": [
"AAPL"
],
"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}."
},
"language": {
"enum": [
"English",
"Chinese"
],
"type": "string",
"default": "English"
}
},
"additionalProperties": false
}
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 consist
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"examples": [
"AAPL"
],
"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}."
}
},
"additionalProperties": false
}
as_filed
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 reve
Показать схему аргументов
{
"type": "object",
"required": [
"ticker",
"date"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"examples": [
"2020-02-01"
],
"description": "The day to look back from (YYYY-MM-DD, 2009-01-01 or later, not in the future)."
},
"limit": {
"type": "integer",
"default": 4,
"maximum": 20,
"minimum": 1,
"description": "How many of the most recent periods filed by `date` to return."
},
"period": {
"enum": [
"annual",
"quarterly"
],
"type": "string",
"default": "annual"
},
"ticker": {
"type": "string",
"pattern": "^[A-Z]{1,5}([.-][A-Z]{1,2})?$",
"examples": [
"AAPL"
],
"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}."
},
"metrics": {
"type": "string",
"examples": [
"revenues,net_income,eps_diluted"
],
"description": "Comma-separated metric names (snake_case), at most 20."
}
},
"additionalProperties": false
}
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 st
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"pattern": "^[A-Z]{1,5}([.-][A-Z]{1,2})?$",
"examples": [
"KO"
],
"description": "US listing symbol, e.g. KO or BRK.B."
}
},
"additionalProperties": false
}
smart_money_holdings
Returns every guru from our 60-name roster who held the requested ticker as of the latest 13F-HR quarter (or a specific historical quarter). Each row includes shares, USD value, % of portfolio, and the auto-classified delta vs the prior quarter. (GET https://app.deepvalues.ai/api/v1/smart-money/holdings, e.g. https://app.deepvalues.ai/api/v1/smart-money/holdings?ticker=AAPL — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request data .
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"pattern": "^[A-Z]{1,5}([.-][A-Z]{1,2})?$",
"examples": [
"AAPL"
]
},
"quarter_end": {
"type": "string",
"format": "date",
"description": "ISO date; default = latest available"
}
},
"additionalProperties": false
}
smart_money_changes
All 13F position changes meeting the materiality threshold (new positions, full exits, ≥25% share-count shifts, OR ≥$100M position size) across our entire 60-guru roster, in the requested window. (GET https://app.deepvalues.ai/api/v1/smart-money/changes, e.g. https://app.deepvalues.ai/api/v1/smart-money/changes?since=2026-Q1 — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request data .
Показать схему аргументов
{
"type": "object",
"required": [
"since"
],
"properties": {
"since": {
"type": "string",
"examples": [
"2026-Q1"
],
"description": "ISO date OR YYYY-QN format. Filters on the QUARTER a position belongs to (quarter_end), not on when it was filed."
},
"status": {
"enum": [
"new",
"added",
"trimmed",
"exited"
],
"type": "string"
},
"filed_since": {
"type": "string",
"format": "date",
"examples": [
"2026-08-10"
],
"description": "Only rows that reached us on or after this date (each row carries filed_at). Use it to poll for genuinely new 13F filings; `since` alone cannot tell a filing from this week from one made months ago in the same quarter."
},
"min_position_usd": {
"type": "number",
"examples": [
100000000
]
}
},
"additionalProperties": false
}
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
Показать схему аргументов
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200
},
"slugs": {
"type": "string",
"examples": [
"warren-buffett,li-lu"
],
"description": "Comma-separated guru slugs; default is every guru."
},
"filed_since": {
"type": "string",
"format": "date",
"examples": [
"2026-08-01"
],
"description": "Only moves filed on or after this date. Poll with it."
}
},
"additionalProperties": false
}
verdict
One guru's disclosed move in one ticker, with the sentence Deep Values publishes about it and every number behind it: the company's legal name beside the ticker ( name , null where we hold none), the three dates (traded by, filed, seen), the quarter-end close, the current price, and the intrinsic value band. value is the callable band (the lead value ±25%: Owner Earnings, else the DCF, else Damodaran) and is null whenever the verdict is not a call; estimates always carries what the valuation methods actually said, their lowest and highest central estimate, so a reader told we cannot call it ca
Показать схему аргументов
{
"type": "object",
"required": [
"ticker",
"guru"
],
"properties": {
"guru": {
"type": "string",
"examples": [
"warren-buffett"
]
},
"ticker": {
"type": "string",
"examples": [
"OXY"
],
"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}."
},
"quarter": {
"type": "string",
"format": "date",
"examples": [
"2026-06-30"
],
"description": "Quarter end; default = the most recent quarter we hold."
}
},
"additionalProperties": false
}
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 .
Показать схему аргументов
{
"type": "object",
"required": [
"ticker",
"guru"
],
"properties": {
"guru": {
"type": "string",
"examples": [
"warren-buffett"
]
},
"ticker": {
"type": "string",
"examples": [
"OXY"
],
"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}."
},
"quarter": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false
}
gurus
60 hand-picked institutional investors — every name a serious value investor would recognize. Filter by style. (GET https://app.deepvalues.ai/api/v1/gurus — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request data .
Показать схему аргументов
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 100,
"maximum": 200
},
"style": {
"enum": [
"value",
"growth",
"activist",
"macro",
"quant"
],
"type": "string"
}
},
"additionalProperties": false
}
guru
One guru: bio + top holdings (GET https://app.deepvalues.ai/api/v1/gurus/{slug}, e.g. https://app.deepvalues.ai/api/v1/gurus/warren-buffett — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request data .
Показать схему аргументов
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"examples": [
"warren-buffett"
],
"description": "Guru slug from GET /gurus, e.g. warren-buffett."
}
},
"additionalProperties": false
}
guru_portfolio
One guru's full portfolio at a quarter (GET https://app.deepvalues.ai/api/v1/gurus/{slug}/portfolio, e.g. https://app.deepvalues.ai/api/v1/gurus/warren-buffett/portfolio — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request data .
Показать схему аргументов
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"examples": [
"warren-buffett"
],
"description": "Guru slug from GET /gurus, e.g. warren-buffett."
},
"as_of": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false
}
theses
Public investment theses with structured metadata — sentiment, conviction, price target, anchored DVI run. Filter by ticker, conviction, or sentiment. (GET https://app.deepvalues.ai/api/v1/theses — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request data .
Показать схему аргументов
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200
},
"ticker": {
"type": "string",
"examples": [
"AAPL"
]
},
"sentiment": {
"enum": [
"bullish",
"bearish",
"neutral"
],
"type": "string"
},
"min_conviction": {
"type": "integer",
"maximum": 5,
"minimum": 1
}
},
"additionalProperties": false
}
indicators_buffett
US corporate equities ÷ GDP, with zones (significantly undervalued through significantly overvalued) and historical percentile. (GET https://app.deepvalues.ai/api/v1/indicators/buffett — 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 .
Показать схему аргументов
{
"type": "object",
"properties": {
"history_years": {
"type": "integer",
"default": 5,
"maximum": 50
}
},
"additionalProperties": false
}
indicators_shiller_pe
Shiller PE with historical percentile (GET https://app.deepvalues.ai/api/v1/indicators/shiller-pe — 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 .
Показать схему аргументов
{
"type": "object",
"properties": {
"history_years": {
"type": "integer",
"default": 5,
"maximum": 100
}
},
"additionalProperties": false
}
sentiment
Value-investor sentiment rollup (not WSB noise) (GET https://app.deepvalues.ai/api/v1/sentiment/{ticker}, e.g. https://app.deepvalues.ai/api/v1/sentiment/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 .
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"source": {
"enum": [
"reddit",
"stocktwits",
"combined"
],
"type": "string",
"default": "combined"
},
"ticker": {
"type": "string",
"examples": [
"AAPL"
],
"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}."
},
"window": {
"enum": [
"24h",
"7d",
"30d"
],
"type": "string",
"default": "7d"
}
},
"additionalProperties": false
}
news
Sentiment-scored news (GET https://app.deepvalues.ai/api/v1/news/{ticker}, e.g. https://app.deepvalues.ai/api/v1/news/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 .
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"since": {
"type": "string",
"format": "date"
},
"ticker": {
"type": "string",
"examples": [
"AAPL"
],
"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}."
},
"sentiment": {
"enum": [
"bullish",
"bearish",
"neutral"
],
"type": "string"
}
},
"additionalProperties": false
}
companies_search
Company search (GET https://app.deepvalues.ai/api/v1/companies — 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 .
Показать схему аргументов
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100
}
},
"additionalProperties": false
}
company_overview
Company overview (GET https://app.deepvalues.ai/api/v1/companies/{ticker}/overview, e.g. https://app.deepvalues.ai/api/v1/companies/AAPL/overview — 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 .
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"examples": [
"AAPL"
],
"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}."
}
},
"additionalProperties": false
}
fundamentals
Income + balance + cashflow (GET https://app.deepvalues.ai/api/v1/fundamentals/{ticker}, e.g. https://app.deepvalues.ai/api/v1/fundamentals/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 .
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 20
},
"period": {
"enum": [
"annual",
"quarterly"
],
"type": "string",
"default": "annual"
},
"ticker": {
"type": "string",
"examples": [
"AAPL"
],
"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}."
}
},
"additionalProperties": false
}
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 .
Показать схему аргументов
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"form": {
"type": "string",
"examples": [
"10-K"
]
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50
},
"ticker": {
"type": "string",
"examples": [
"AAPL"
],
"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}."
}
},
"additionalProperties": false
}
webhooks_list
List webhook subscriptions (GET https://app.deepvalues.ai/api/v1/webhooks — free; needs a connected account or a dv sk key)
Показать схему аргументов
{
"type": "object",
"properties": [],
"additionalProperties": false
}