FOR AI AGENTS — NO HUMAN NEEDED

Get a key, call the API and pay for it, all over HTTP

No account, no dashboard, no browser. The same steps, machine-readable: /llms.txt, /.well-known/agent.json, OpenAPI. MCP clients: https://app.deepvalues.ai/api/mcp (Streamable HTTP). Open-source research corpus (CC BY 4.0, markdown twins, index.json): research.deepvalues.ai/for-agents/.

  1. 1. Try it with no key

    21 read endpoints answer without any Authorization header, up to 25 calls per IP per day (ai-context: 1/day, intrinsic-value: 5/day, as-filed: 5/day, brief: 1/day, smart-money-holdings: 5/day, smart-money-changes: 5/day, guru-moves: 5/day, verdict: 5/day, mirror-brief: 5/day, gurus: 5/day, guru: 5/day, guru-portfolio: 5/day, theses: 5/day). Watch X-RateLimit-Remaining; the Link: …; rel="register" header points at step 2.

    Keyless endpoints: ai-context, intrinsic-value, as-filed, brief, smart-money-holdings, smart-money-changes, guru-moves, verdict, mirror-brief, gurus, guru, guru-portfolio, theses, indicators-buffett, indicators-shiller-pe, sentiment, news, companies-search, company-overview, fundamentals, filings. /research has no keyless allowance: send a key, or pay it per call with x402.

    curl -s "https://app.deepvalues.ai/api/v1/fundamentals/AAPL"
  2. 2. Get a key

    One unauthenticated POST. No account, no browser, no human.

    {} → a dv_sk_test_ sandbox key: real data, never billed, 100 metadata calls/day per address, no /research.

    {"email":"…"} → a dv_sk_live_ key on a new prepaid account. The first key for an email carries 1 starter credit ($1), and every live key's owner gets 250 free reference reads a day; at most 3 starter grants and 10 keys per IP per day.

    The raw key is shown once and is the only credential — the email is a contact label, not a login. POST again WITH the key as bearer to mint a sibling (rotation); GET https://app.deepvalues.ai/api/v1/keys/me for balance + quota; DELETE it to revoke.

    curl -s -X POST "https://app.deepvalues.ai/api/v1/keys" \ -H "Content-Type: application/json" \ -d '{"email":"agent@example.com"}'
  3. 3. Prices

    1 credit = $1.00. Prices are per successful call and often fractional — parse them as decimals: 0.001 credits ($0.001) × 8 endpoints; 0.01 credits ($0.01) × 8 endpoints; 0.02 credits ($0.02) × 4 endpoints; 0.25 credits ($0.25) × 2 endpoints. Everything else is free.

    Reference reads (fundamentals, filings, news, sentiment, indicators, company search and overview): $0.001 a call with a key or credits, the first 250 a day free per live key owner; $0.005 when paid per call over x402.

    Valuation outputs: $0.01 (smart money, gurus, guru moves, mirror brief, theses) to $0.02 (intrinsic value, verdict, ai-context, as-filed).

    Answers: $0.25 — brief (1 free a day) and research. Same price, different products: brief is a short valuation answer computed at call time (value, margin of safety, verdict, holders); research is the full written multi-analyst briefing, the latest one completed.

    One company end to end (20 reference reads + 5 valuation outputs at $0.02 + 1 brief + 1 research) costs about $0.62, billed as separate calls: no single payment is above $0.25, within the $1 default cap of the x402 v2 client (the v1 x402-fetch default of $0.10 needs raising for the $0.25 answers).

    A call is charged only after it returns 2xx; errors are never billed. The per-endpoint price is price_credits in https://app.deepvalues.ai/api/v1/pricing.json (and agent.json, and the list below). Human-readable: https://app.deepvalues.ai/en/developers#agents-pricing. The call below returns your exact balanceMicro.

    curl -s "https://app.deepvalues.ai/api/v1/keys/me" -H "Authorization: Bearer $DV_API_KEY"
  4. 4. Payment

    When a priced call cannot be paid you get HTTP 402 with payment_options, the ways to pay in the order to try them. Nothing was charged.

    First choice, by card: a person buys credits at https://app.deepvalues.ai/pricing#credit-packs (sign in or create an account; 10 credits $9.99, 50 credits $39.99, 200 credits $100; 1 credit = $1 of calls), creates a live API key at https://app.deepvalues.ai/account/api-keys, and the agent sends it as Authorization: Bearer dv_sk_live_… (for MCP, add the header to the server config, or add the server as https://app.deepvalues.ai/api/mcp?login and sign in). Without a browser account: mint a key over the API (see Get a key), then POST the call below with it: it returns { "checkoutUrl": "https://checkout.stripe.com/…" }, a Stripe page a person pays by card. A keyed 402 already carries one as topUp.checkoutUrl (null if Stripe could not be reached — then POST topUp.checkoutEndpoint). Packs: "1000" = 10 credits, "5000" = 50 credits, "20000" = 200 credits. Credits land on the key’s balance when Stripe confirms; poll keys/me, then retry.

    x402 (USDC paid by the agent itself, no human) is not switched on yet: the 402 body says so and carries no accepts. Until it is, a person pays by card.

    curl -s -X POST "https://app.deepvalues.ai/api/v1/credits/checkout" \ -H "Authorization: Bearer $DV_API_KEY" -H "Content-Type: application/json" \ -d '{"pack":"1000"}'
  5. 5. Quotas

    Daily buckets per live key, reset 00:00 UTC: metadata 10,000, ai_research 50, webhook_events 1,000. Over quota → HTTP 429 (RFC 7807) with retry_after_seconds.

    Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Bucket.

Price per successful call

EndpointWhat it returnsUSDx402 per call
GET /ai-context/{ticker}
e.g. /ai-context/AAPL
Drop-in AI grounding context (DIFFERENTIATED)$0.02$0.02
GET /research/{ticker}
e.g. /research/AAPL
AI multi-analyst research briefing (HEADLINE)$0.25$0.25
GET /intrinsic-value/{ticker}
e.g. /intrinsic-value/AAPL
DCF + Owner Earnings + Damodaran intrinsic value$0.02$0.02
GET /as-filed/{ticker}
e.g. /as-filed/AAPL?date=2020-02-01
Point-in-time fundamentals: what was filed as of a date, before restatement$0.02$0.02
GET /brief/{ticker}
e.g. /brief/AAPL
One-call valuation brief: intrinsic value, margin of safety, verdict, guru holders$0.25$0.25
GET /smart-money/holdings
e.g. /smart-money/holdings?ticker=AAPL
Which curated gurus hold this ticker$0.01$0.01
GET /smart-money/changes
e.g. /smart-money/changes?since=2026-Q1
Material guru moves in a time window$0.01$0.01
GET /gurus/movesMaterial guru moves, newest filing first, each with its verdict$0.01$0.01
GET /verdict/{ticker}
e.g. /verdict/AAPL?guru=warren-buffett
The verdict line for one filed move$0.02$0.02
GET /mirror-brief/{ticker}
e.g. /mirror-brief/AAPL?guru=warren-buffett
An impersonal brief on one filed move, for an agent to act on$0.01$0.01
GET /gurusCurated guru roster$0.01$0.01
GET /gurus/{slug}
e.g. /gurus/warren-buffett
One guru: bio + top holdings$0.01$0.01
GET /gurus/{slug}/portfolio
e.g. /gurus/warren-buffett/portfolio
One guru's full portfolio at a quarter$0.01$0.01
GET /thesesStructured human investment theses$0.01$0.01
GET /indicators/buffettBuffett Indicator with zone classification$0.001$0.005
GET /indicators/shiller-peShiller PE with historical percentile$0.001$0.005
GET /sentiment/{ticker}
e.g. /sentiment/AAPL
Value-investor sentiment rollup (not WSB noise)$0.001$0.005
GET /news/{ticker}
e.g. /news/AAPL
Sentiment-scored news$0.001$0.005
GET /companiesCompany search$0.001$0.005
GET /companies/{ticker}/overview
e.g. /companies/AAPL/overview
Company overview$0.001$0.005
GET /fundamentals/{ticker}
e.g. /fundamentals/AAPL
Income + balance + cashflow$0.001$0.005
GET /filings/{ticker}
e.g. /filings/AAPL
SEC filings (10-K, 10-Q, 8-K, etc)$0.001$0.005

1 credit = $1.00. Key management, webhooks and checkout are free. Errors are never billed. A live key gets 250 free $0.001 reads a day. Paid per call over x402, a price below $0.005 is quoted at $0.005: each on-chain settlement carries a facilitator fee, so cheap reads are cheaper with a key and a $1 top-up. The x402 market rate for raw fields is $0.01 to $0.02; our fields are $0.001 and our valuation outputs $0.01 to $0.02.

Errors

Every error is RFC 7807 application/problem+json. Branch on type, which is https://app.deepvalues.ai/developers/errors/<slug>; detail is for people.

type slugHTTPMeaning
missing-key401No Authorization header on an endpoint that needs a key. Mint one with POST /api/v1/keys.
invalid-key401The bearer is not a well-formed dv_sk_ key, or no such key exists.
revoked-key401The key was revoked. Mint a new one.
insufficient-scope403The key lacks the scope this endpoint requires.
sandbox-restricted403Test (dv_sk_test_) keys cannot call this endpoint — /research is live-only. Use a live key.
origin-forbidden403The request did not come through https://app.deepvalues.ai.
live-key-required403Only a live key can do this (for example, buy credits).
quota-exceeded429The daily quota for this bucket is used up. Resets at 00:00 UTC; see Retry-After.
anonymous-quota-exceeded429The keyless allowance for this address is used up. Mint a key.
key-issuance-rate-limited429Too many keys minted from this address today.
insufficient-credits402The call is not paid for. Pay by card (a person buys credits at /pricing#credit-packs and creates a key at /account/api-keys, or pays topUp.checkoutUrl), or with x402 (sign the PAYMENT-REQUIRED quote, resend with PAYMENT-SIGNATURE); payment_options lists both, in that order. Nothing was charged.
settlement-not-credited500An x402 payment settled but was not credited. Do not pay again: resend the same payment header to have it credited, or contact support with the reference.
settlement-pending503An x402 settlement was not confirmed in time. Do NOT sign a new payment; resend the same payment header after Retry-After.
payment-in-progress409Another request carrying this exact x402 payment is in flight. Wait for it or resend in a few seconds; do not sign a new payment.
payment-rail-unavailable503USDC (x402) payments cannot be recorded right now; nothing was settled or charged. Retry later or pay by card.
x402-disabled503USDC (x402) payment is switched off on this deployment; `detail` says why. Buy credits by card via POST /credits/checkout.
invalid-credits400POST /credits/top-up needs ?credits=N, a whole number within the allowed range.
billing-unavailable503The call could not be metered, so it was not served. Nothing was charged; retry.
invalid-parameter400A query or body parameter is missing or malformed; `detail` names it.
invalid-ticker400The ticker is not a valid symbol.
invalid-id400The id in the path is malformed.
invalid-email400The email in a key request is not an address.
invalid-pack400Unknown credit pack.
invalid-events400A webhook subscription named an unknown event type.
missing-events400A webhook subscription named no event types.
invalid-webhook-url400The webhook URL is not a valid URL.
insecure-webhook-url400Webhook URLs must be https.
too-many-webhooks429The key already has the maximum number of webhook subscriptions.
not-found404Nothing exists at this path or id.
ticker-not-found404No company with this ticker.
research-not-found404No research briefing exists for this ticker yet.
unknown-endpoint404No endpoint at this path. `did_you_mean` lists the closest real ones; `request_data` takes a request for one we lack.
invalid-data-request400POST /request-data needs `want` (3-500 characters) and, if sent, a known `kind`.
data-request-rate-limited429Too many data requests from this address (or from everyone) today. The ones already sent are recorded.
request-data-unavailable503Data requests cannot be recorded right now. Retry later.
method-not-allowed405Wrong HTTP method; see the Allow header.
research-upstream502The research engine did not answer. Not charged; retry.
upstream-unavailable502A data source is temporarily unavailable. Not charged; retry.
checkout-unavailable502Stripe Checkout could not be opened. Retry.
as-filed-unavailable503No as-filed history to answer from: not loaded on this deployment yet, or none for this company. Not charged; /fundamentals has current figures.
live-keys-unavailable503Live keys are not being issued right now. Sandbox keys still work.
key-issuance-unavailable503Key issuance is temporarily unavailable. Retry later.
internal500Unexpected server error. Not charged; retry.
For developers
Beta access available now
Deep Values APIDrop-in equity research that thinks like a Berkshire analyst, not a data dashboard.Build value-investing products in days, not quarters. We do the multi-analyst AI work, the 13F curation, and the sentiment plumbing — you call one endpoint and get the answer.
Get API key
View docs
v1.0 · REST + MCP · pay per call
Three things nobody else gives you at this price
AI equity research as JSONOne endpoint. Full briefing. Bull case, bear case, valuation snapshot, investment plan, intrinsic-value range. The same multi-analyst pipeline that powers our consumer product, exposed as a single JSON call. Sentieo and AlphaSense cost $30,000 a year; here a briefing is $3 a call.
The Smart Money API103 tracked investors. Real 13F filings. Auto-classified position deltas. Materiality-filtered notifications. Buffett, Burry, Ackman, Druckenmiller, Li Lu, Duan Yongping and many more: every holding row carries its change vs the prior quarter, so you do not have to join on the client. The data nobody else packages this way at any price.
Drop-in AI context for buildersBuilding a stock-aware GPT? An investing copilot? A research assistant inside your app? Our /v1/ai-context endpoint returns a ready-to-use system prompt + ~6000-token structured data block, scoped to one ticker. Drop it into OpenAI, Anthropic, or any LLM SDK — we do the grounding, you build the product.
The full endpoint menu
Everything you can call from day one. Full OpenAPI spec linked below.
Research
GET /api/v1/research/{ticker}e.g. GET /api/v1/research/AAPLFull multi-analyst AI report (chargeable)
Smart Money
GET /api/v1/smart-money/holdings?ticker=Xe.g. GET /api/v1/smart-money/holdings?ticker=AAPLWho from our roster holds X, deltas, %
GET /api/v1/smart-money/changes?since=...e.g. GET /api/v1/smart-money/changes?since=2026-01-01All material moves in window
Gurus
GET /api/v1/gurusThe 103 tracked investors + each one's top holdings
GET /api/v1/gurus/{slug}e.g. GET /api/v1/gurus/warren-buffettOne guru full portfolio + history + bio
Theses
GET /api/v1/theses?ticker=Xe.g. GET /api/v1/theses?ticker=AAPLStructured human investment views
GET /api/v1/intrinsic-value/{ticker}e.g. GET /api/v1/intrinsic-value/AAPLDCF + Owner Earnings + Damodaran scenarios
Indicators
GET /api/v1/indicators/buffettBuffett Indicator + zone (over/fair/under)
GET /api/v1/indicators/shiller-peShiller PE + percentile vs history
Companies
GET /api/v1/fundamentals/{ticker}e.g. GET /api/v1/fundamentals/AAPLIncome + balance + cashflow, annual + quarterly
Filings
GET /api/v1/filings/{ticker}e.g. GET /api/v1/filings/AAPL10-K, 10-Q, 8-K, DEF 14A with parsed sections
News & Sentiment
GET /api/v1/news/{ticker}e.g. GET /api/v1/news/AAPLSentiment-scored news, latest first
GET /api/v1/sentiment/{ticker}?source=...e.g. GET /api/v1/sentiment/AAPL?source=combinedValue-investor sentiment (NOT WSB noise)
AI Context
GET /api/v1/ai-context/{ticker}e.g. GET /api/v1/ai-context/AAPLDrop-in grounding for chatbot builders
Webhooks
POST /api/v1/webhooksSubscribe to events (guru moves, new filings, sentiment shifts)
Pricing
Pay per callFrom prepaid credits, the same credits the app uses: 1 credit = $1. No subscription, no monthly minimum, and a call that errors is never billed.
Data endpoints: from 0.001 credits a call
An AI research briefing: 3 credits a call
Key management, webhooks and checkout: free
Top up from $9.99 for 10 credits, or let your agent pay its own 402
Every endpoint's price is in the table above ↑
Custom tier for higher volume, white-label, or private guru universes (track your own watchlist of 13F filers): hello@deepvalues.ai.
Priced per call, not per seat
Institutional research and 13F tooling are sold as annual seats and monthly plans. Here you prepay credits and pay only for the calls you make.
ProviderWhat you getPrice
You are here
Deep Values
AI research as JSON, 103 tracked investors, drop-in chatbot context.$0.001–$3 / call
Sentieo / AlphaSense
Institutional research terminal — enterprise sales motion, multi-year contracts.$30,000+ / yr
WhaleWisdom
13F tooling only. No AI synthesis, no sentiment, no grounding context.$1,000+ / mo
We focus on the value-investing slice nobody else serves at this price: AI synthesis + curated Smart Money + grounding context.
Quick start
Four lines of curl: no key, your own key, prices, paying a 402.
bash
Step 1 of 4 · No key
# 1. No key, no account — 25 calls a day per address
curl -s "https://app.deepvalues.ai/api/v1/fundamentals/AAPL"
Connect over MCP
The same tools in Claude, Cursor or any MCP client: one endpoint, Streamable HTTP.https://app.deepvalues.ai/api/mcp
No credentials needed to start: the read tools have a free daily allowance per address.
Sign in with your DeepValues account over OAuth 2.1 (connect https://app.deepvalues.ai/api/mcp?login and your client opens the browser), or send an API key, to unlock the paid tools such as research.
Listed in the official MCP Registry as ai.deepvalues/deepvalues.
Claude Codeterminal
claude mcp add --transport http deepvalues https://app.deepvalues.ai/api/mcp # or with an API key: claude mcp add --transport http deepvalues https://app.deepvalues.ai/api/mcp \ --header "Authorization: Bearer dv_sk_live_…"
Claude Desktopclaude_desktop_config.json
{ "mcpServers": { "deepvalues": { "command": "npx", "args": [ "-y", "mcp-remote", "https://app.deepvalues.ai/api/mcp" ] } } }
Cursor~/.cursor/mcp.json
{ "mcpServers": { "deepvalues": { "url": "https://app.deepvalues.ai/api/mcp" } } }
In Claude Desktop you can also add it under Settings → Connectors → Add custom connector, with the URL above.
Who this is for
Newsletter writers + Substack stock-pickersPull live 13F deltas into your Monday morning post. "Berkshire trimmed AAPL by 1.1% last quarter — here is the data." One API call, no scraping.
Robo-advisors + portfolio productsShow your users what the smart money is doing without licensing WhaleWisdom at $1k+/mo. Add AI-generated stock briefings as a premium feature with zero in-house AI infra.
AI app buildersDrop our ai-context endpoint into your GPT / Claude / Llama wrapper and your chatbot is suddenly grounded in real fundamentals, 13F data, and sentiment. No prompt-engineering required.
Small funds + family officesUse our 103 tracked investors as your own competitor monitoring. Get webhook-notified the day a competitor exits a position you also hold.
Quants + researchersBacktest against curated guru moves over 4+ years of history. Build sentiment-weighted strategies from the value-investing-focused subreddit feed (not the meme-stock noise).
FAQ
It returns the latest completed briefing for the ticker, the same one the app shows, until a newer run replaces it. A call never starts a new run; a ticker with no briefing yet answers 404 and says how to request one.
13F deltas: real-time vs SEC EDGAR (we re-poll every 30 minutes after the 4pm-ET filing window). Fundamentals: end-of-day. News + sentiment: hourly. Indicators: daily. AI research: synthesized on first call, cached 14 days.
Using the results inside your own product, for your own users, is what the API is for. Reselling the raw API is not allowed; for anything else, write to hello@deepvalues.ai.
We do not do those. Polygon ($99–2000/mo) is the best of breed for real-time tape. Quiver Quantitative covers gov + insider data. We focus on the value-investing slice nobody else serves at this price.
No. Prepaid credits never expire. Each key also has daily quotas per endpoint group, which reset at 00:00 UTC; GET /api/v1/keys/me shows your balance and quotas.
No: there is no subscription to attach one to. You pay per successful call, and a call that errors is never billed.
Yes. Most read endpoints answer with no key at all, up to 25 calls a day per address, and POST /api/v1/keys with {} returns a dv_sk_test_ sandbox key: real data, never billed.
For developers
Last updated Oct 7, 2026. Built by Deep Values in San Francisco.