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).

  1. 1. Try it with no key

    19 read endpoints answer without any Authorization header, up to 25 calls per IP per day (ai-context: 1/day). Watch X-RateLimit-Remaining; the Link: …; rel="register" header points at step 2.

    Keyless endpoints: ai-context, intrinsic-value, 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 is never keyless.

    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 carries 1 starter credit ($1at 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.005 credits ($0.005) × 11 endpoints; 3 credits ($3) × 1 endpoint. Everything else is free.

    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/.well-known/agent.json and in 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 the balance cannot cover a call you get HTTP 402 (RFC 7807 problem+json) with price_credits, balance_micro and a topUp object. Nothing was charged.

    topUp.checkoutUrl is a ready-to-pay Stripe Checkout link for the smallest pack (null if Stripe could not be reached — then POST topUp.checkoutEndpoint). Packs: "1000" = 10 credits, "5000" = 50 credits, "20000" = 200 credits. The POST below returns { "checkoutUrl": "https://checkout.stripe.com/…" }. Credits land on the key’s balance when Stripe confirms; poll keys/me, then retry.

    x402 (USDC, pay-in-the-retry) is not switched on yet: the 402 body says so and carries no accepts.

    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 returnsUSD
GET /ai-context/{ticker}Drop-in AI grounding context (DIFFERENTIATED)$0.005
GET /research/{ticker}AI multi-analyst research briefing (HEADLINE)$3
GET /intrinsic-value/{ticker}DCF + Owner Earnings + Damodaran intrinsic value$0.005
GET /smart-money/holdingsWhich curated gurus hold this ticker$0.005
GET /smart-money/changesMaterial guru moves in a time window$0.005
GET /gurus/movesMaterial guru moves, newest filing first, each with its verdict$0.005
GET /verdict/{ticker}The verdict line for one filed move$0.005
GET /mirror-brief/{ticker}An impersonal brief on one filed move, for an agent to act on$0.005
GET /gurusCurated guru roster$0.005
GET /gurus/{slug}One guru: bio + top holdings$0.005
GET /gurus/{slug}/portfolioOne guru's full portfolio at a quarter$0.005
GET /thesesStructured human investment theses$0.005
GET /indicators/buffettBuffett Indicator with zone classification$0.001
GET /indicators/shiller-peShiller PE with historical percentile$0.001
GET /sentiment/{ticker}Value-investor sentiment rollup (not WSB noise)$0.001
GET /news/{ticker}Sentiment-scored news$0.001
GET /companiesCompany search$0.001
GET /companies/{ticker}/overviewCompany overview$0.001
GET /fundamentals/{ticker}Income + balance + cashflow$0.001
GET /filings/{ticker}SEC filings (10-K, 10-Q, 8-K, etc)$0.001

1 credit = $1.00. Key management, webhooks and checkout are free. Errors are never billed.

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, fair-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 API93 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}Full multi-analyst AI report (chargeable)
Smart Money
GET /api/v1/smart-money/holdings?ticker=XWho from our roster holds X, deltas, %
GET /api/v1/smart-money/changes?since=...All material moves in window
Gurus
GET /api/v1/gurusThe 93 tracked investors + each one's top holdings
GET /api/v1/gurus/{slug}One guru full portfolio + history + bio
Theses
GET /api/v1/theses?ticker=XStructured human investment views
GET /api/v1/intrinsic-value/{ticker}DCF + 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}Income + balance + cashflow, annual + quarterly
Filings
GET /api/v1/filings/{ticker}10-K, 10-Q, 8-K, DEF 14A with parsed sections
News & Sentiment
GET /api/v1/news/{ticker}Sentiment-scored news, latest first
GET /api/v1/sentiment/{ticker}?source=...Value-investor sentiment (NOT WSB noise)
AI Context
GET /api/v1/ai-context/{ticker}Drop-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.
Get API key
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, 93 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 93 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
Read the docs
Contact sales
Last updated Oct 7, 2026. Built by Deep Values in San Francisco.