For agents & developers
DeepValues Research is open by design: every report opens with a quotable answer box, has a markdown twin and structured data, all crawlers (including AI search and assistant crawlers) are welcome, and the text is licensed CC BY 4.0. For live numbers, use the DeepValues API.
In brief
DeepValues Research (research.deepvalues.ai) is the open-source research library of DeepValues (LuLu Ventures LLC): 1402 documents on 309 listed companies, in English and Chinese, licensed CC BY 4.0. Its Deep Value Intelligence reports end in a dated ADVOCATE (bullish), WATCH (neutral) or AVOID (bearish) stance with a 0–5 score; 289 companies currently have a stance. Cite as “DeepValues Research, <title>, <canonical URL>”. Reports are educational research snapshots, not investment advice.
Start here
- Need a stance or a number for one company? Read
/api/stances.json(latest stance per ticker) or the report's answer box:section[data-answer] .answer-text, alsoabstractin the page's Article JSON-LD andanswer:in the markdown twin's front matter. - Need the full report as text? Append
index.mdto any report URL. The front matter carries title, ticker, date, stance, score, answer, canonical URL and licence. - Need an index?
/llms.txt(summary, newest stances and reports),/index.json(every company) or the sitemap. - Need live fundamentals, intrinsic values or guru holdings? The DeepValues API: OpenAPI, MCP, a keyless trial and pay-per-call credits (details).
Endpoints on this site
| URL | What it is |
|---|---|
/api/stances.json | Latest Deep Value Intelligence stance per ticker: verdict (ADVOCATE / WATCH / AVOID), Bullish / Neutral / Bearish, 0–5 score, report date, canonical report URL (HTML, markdown, Chinese twin), sector, Wikidata ID and the report's answer sentence. 289 companies. Described as a schema.org Dataset on this page. |
<report-url> | Each report page opens with an answer box (<section data-answer>, 2–4 plain sentences: stance, thesis, key figures) marked speakable in JSON-LD, followed by key takeaways, the full report and a short visible FAQ with FAQPage JSON-LD. The Article JSON-LD names the company as a Corporation with tickerSymbol and Wikidata / Wikipedia sameAs links. |
<report-url>index.md | Raw markdown of any report with YAML front matter (title, author, ticker, company, date, language, stance, score, answer, canonical_url, license, cite_as). Also announced in each page head as <link rel="alternate" type="text/markdown"> and as encoding in JSON-LD. |
/index.json | Every company: name, report count, sector, latest stance and the latest EN/ZH report URLs (HTML and markdown). Keys are tickers. |
/llms.txt | Site summary for language models (llmstxt.org format): what the site is, how to cite, machine endpoints, API links, the newest stances and reports. |
/llms-full.txt | The latest 100 reports as plain text, each headed by title, canonical URL, date, stance and answer. |
/feed.xml · /atom.xml | RSS 2.0 and Atom feeds of the latest 50 reports (Atom entries link the markdown twin). |
/sitemap.xml | All pages with last-modified dates and hreflang alternates. |
/search-index.json | Compact title/ticker/date/language index of every document (array rows: title, ticker, company, date, lang, section, url). |
Answer box example
From https://research.deepvalues.ai/company/aapl/2026-09-12-en/. The same sentences are abstract in the page's JSON-LD and answer: in its markdown twin, so the three never disagree:
As of Sep 12, 2026, DeepValues Research rates Apple (AAPL) Bullish (ADVOCATE, score 2.58/5). Apple is the quintessential "wonderful business," boasting an elite 82.3% ROIC and an unmatched consumer ecosystem. Key figures: share price $332; headline intrinsic value $209 (margin of safety -59.2%); P/E (TTM) 37.46; free-cash-flow yield 2.0%.
stances.json example
One entry (the file holds 289); score is the report's weighted 0–5 scorecard total and date the report date:
{
"name": "DeepValues Research stances",
"description": "Latest Deep Value Intelligence stance per ticker (ADVOCATE = bullish, WATCH = neutral, AVOID = bearish) with its 0-5 scorecard total, report date and canonical report URL. Each stance is a dated research snapshot, not investment advice.",
"url": "https://research.deepvalues.ai/api/stances.json",
"source": "https://research.deepvalues.ai/",
"generated": "2026-10-26",
"publisher": "DeepValues Research",
"license": "CC BY 4.0",
"license_url": "https://creativecommons.org/licenses/by/4.0/",
"cite_as": "DeepValues Research, Stances dataset, https://research.deepvalues.ai/api/stances.json",
"scale": {
"ADVOCATE": "Bullish",
"WATCH": "Neutral",
"AVOID": "Bearish",
"score": "weighted scorecard, 0 (weakest) to 5 (strongest)"
},
"lang": "en",
"locales": [
"en",
"de",
"es-419",
"es-ES",
"fr",
"hi",
"id",
"it",
"ja",
"ko",
"pt-BR",
"zh-Hans",
"zh-Hant"
],
"stance_labels": {
"ADVOCATE": {
"en": "Bullish",
"de": "Bullish",
"es-419": "Alcista",
"es-ES": "Alcista",
"fr": "Haussier",
"hi": "Bullish",
"id": "Bullish",
"it": "Rialzista",
"ja": "強気",
"ko": "강세",
"pt-BR": "Altista",
"zh-Hans": "看多",
"zh-Hant": "看多"
},
"WATCH": {
"en": "Neutral",
"de": "Neutral",
"es-419": "Neutral",
"es-ES": "Neutral",
"fr": "Neutre",
"hi": "Neutral",
"id": "Netral",
"it": "Neutrale",
"ja": "中立",
"ko": "중립",
"pt-BR": "Neutro",
"zh-Hans": "中性",
"zh-Hant": "中性"
},
"AVOID": {
"en": "Bearish",
"de": "Bearish",
"es-419": "Bajista",
"es-ES": "Bajista",
"fr": "Baissier",
"hi": "Bearish",
"id": "Bearish",
"it": "Ribassista",
"ja": "弱気",
"ko": "약세",
"pt-BR": "Baixista",
"zh-Hans": "看空",
"zh-Hant": "看空"
}
},
"live_data": {
"note": "Stances here are from the published reports; for current fundamentals and intrinsic values use the DeepValues API.",
"developers": "https://app.deepvalues.ai/developers",
"openapi": "https://app.deepvalues.ai/api/v1/openapi.json",
"mcp": "https://app.deepvalues.ai/.well-known/mcp.json"
},
"count": 289,
"stances": [
{
"ticker": "AAPL",
"company": "Apple",
"lang": "en",
"verdict": "ADVOCATE",
"stance": "Bullish",
"score": 2.58,
"date": "2026-09-12",
"report_url": "https://research.deepvalues.ai/company/aapl/2026-09-12-en/",
"report_md": "https://research.deepvalues.ai/company/aapl/2026-09-12-en/index.md",
"report_zh": null,
"company_url": "https://research.deepvalues.ai/company/aapl/",
"sector": "Technology",
"industry": "Consumer Electronics",
"wikidata": "https://www.wikidata.org/wiki/Q312",
"answer": "As of Sep 12, 2026, DeepValues Research rates Apple (AAPL) Bullish (ADVOCATE, score 2.58/5). Apple is the quintessential \"wonderful business,\" boasting an elite 82.3% ROIC and an unmatched consumer ecosystem. Key figures: share price $332; headline intrinsic value $209 (margin of safety -59.2%); P/E (TTM) 37.46; free-cash-flow yield 2.0%."
}
]
}
index.json example
{
"AAPL": {
"name": "Apple",
"url": "https://research.deepvalues.ai/company/aapl/",
"report_count": 41,
"sector": "Technology",
"industry": "Consumer Electronics",
"latest": {
"date": "2026-09-12",
"en": "https://research.deepvalues.ai/company/aapl/2026-09-12-en/",
"zh": null,
"en_md": "https://research.deepvalues.ai/company/aapl/2026-09-12-en/index.md",
"zh_md": null,
"translations": {
"de": "https://research.deepvalues.ai/company/aapl/2026-09-12-de/",
"es": "https://research.deepvalues.ai/company/aapl/2026-09-12-es/",
"pt-BR": "https://research.deepvalues.ai/company/aapl/2026-09-12-pt/"
},
"verdict": "ADVOCATE",
"score": 2.58
},
"latest_by_lang": {
"en": {
"date": "2026-09-12",
"url": "https://research.deepvalues.ai/company/aapl/2026-09-12-en/",
"md": "https://research.deepvalues.ai/company/aapl/2026-09-12-en/index.md",
"title": "Apple (AAPL) Deep Value Intelligence Report · Sep 12, 2026"
},
"zh": {
"date": "2026-05-14",
"url": "https://research.deepvalues.ai/company/aapl/2026-05-14-zh/",
"md": "https://research.deepvalues.ai/company/aapl/2026-05-14-zh/index.md",
"title": "Apple(AAPL)深度价值情报报告 · 2026年5月14日"
}
},
"stance": {
"verdict": "ADVOCATE",
"score": 2.58,
"date": "2026-09-12"
}
}
}
Markdown twin example
Append index.md to any report URL, for example /company/aapl/2026-09-12-en/index.md:
---
title: "Apple (AAPL) Deep Value Intelligence Report · Sep 12, 2026"
author: "DeepValues Research"
publisher: "DeepValues Research (DeepValues / LuLu Ventures LLC)"
type: "Deep Value Intelligence report"
ticker: "AAPL"
company: "Apple"
sector: "Technology"
industry: "Consumer Electronics"
wikidata: "https://www.wikidata.org/wiki/Q312"
wikipedia: "https://en.wikipedia.org/wiki/Apple_Inc."
date: "2026-09-12"
language: "en"
section: "Company Research"
stance: "Bullish"
stance_code: "ADVOCATE"
score: 2.58
score_scale: "0-5"
answer: "As of Sep 12, 2026, DeepValues Research rates Apple (AAPL) Bullish (ADVOCATE, score 2.58/5). Apple is the quintessential \"wonderful business,\" boasting an elite 82.3% ROIC and an unmatched consumer ecosystem. Key figures: share price $332; headline intrinsic value $209 (margin of safety -59.2%); P/E (TTM) 37.46; free-cash-flow yield 2.0%."
canonical_url: "https://research.deepvalues.ai/company/aapl/2026-09-12-en/"
markdown_url: "https://research.deepvalues.ai/company/aapl/2026-09-12-en/index.md"
license: "CC BY 4.0"
license_url: "https://creativecommons.org/licenses/by/4.0/"
cite_as: "DeepValues Research, Apple (AAPL) Deep Value Intelligence Report · Sep 12, 2026, https://research.deepvalues.ai/company/aapl/2026-09-12-en/"
…
The DeepValues API (live data, OpenAPI, MCP, pay-per-call)
The reports here are snapshots. Current fundamentals, Buffett-style intrinsic values, owner earnings, stances, SEC filings, 60-guru 13F holdings and an LLM-grounding ai-context block for any US ticker come from the read-only v1 API at https://app.deepvalues.ai/api/v1. Everything below can be done by an agent alone, with no account, browser or human:
| Discovery URL | What it is |
|---|---|
https://app.deepvalues.ai/developers | Human docs, quick start and the per-call price table. |
https://app.deepvalues.ai/api/v1/openapi.json | OpenAPI 3.1 specification (source of truth; every operation carries an x-price). |
https://app.deepvalues.ai/.well-known/mcp.json | MCP tool manifest; the MCP server itself is POST https://app.deepvalues.ai/api/mcp (every read endpoint as a tool, plus keys_create, pricing, credits_checkout). |
https://app.deepvalues.ai/.well-known/agent.json | Capability descriptor for agents (auth, pricing, quotas, the whole loop as data). |
https://app.deepvalues.ai/llms.txt | The API's own llms.txt with per-endpoint markdown contracts under /llms/<slug>.md. |
https://app.deepvalues.ai/api/v1/pricing.json | Machine-readable prices in credits, USD and atomic USDC, allowances, quotas and every way to pay. |
- Try with no key: 19 read endpoints answer without any header, 25 calls per IP per day (
GET https://app.deepvalues.ai/api/v1/fundamentals/AAPL). WatchX-RateLimit-Remaining. - Mint a key:
POST <built-in method keys of dict object at 0x797868ac3680>with{"email": "…"}returns adv_sk_live_key with one starter credit;{}returns a never-billed sandbox key. No account, no login; the key is the only credential. - Pay: a call the balance cannot cover returns HTTP 402 (RFC 7807) with a ready Stripe Checkout link and the credit packs. x402 (the agent pays the 402 itself in USDC on Base, no human) is implemented on the API and switched on by configuration; pricing.json states whether it is live and the 402 body carries the
acceptsquote when it is. - Call: send
Authorization: Bearer dv_sk_…; each successful call debits itsprice_credits(most reads cost $0.001–$0.005; one credit is one US dollar). 429 means wait for 00:00 UTC.
Or ask Deep Value Intelligence for a fresh report on any ticker.
Entities
Companies are identified consistently as “Name (TICKER)” in titles, answer boxes and front matter, and as a schema.org Corporation with tickerSymbol in JSON-LD. 198 of 309 companies carry Wikidata and English Wikipedia sameAs links (resolved from Wikidata by ticker claim P249 or exact label; nothing is guessed). The publisher is always DeepValues Research (https://research.deepvalues.ai/#org), a unit of DeepValues / LuLu Ventures LLC (https://deepvalues.ai/#org).
Crawling and freshness
robots.txt allows every crawler and names the AI search, assistant and training agents explicitly (Googlebot, Google-Extended, Bingbot, OAI-SearchBot, ChatGPT-User, GPTBot, Claude-SearchBot, Claude-User, ClaudeBot, PerplexityBot, Perplexity-User, Applebot, Applebot-Extended, DuckAssistBot, Amazonbot, meta-externalagent, meta-externalfetcher, MistralAI-User, CCBot, Bytespider, YouBot). It carries a Content Signals line, Content-Signal: search=yes, ai-input=yes, ai-train=yes: search indexing, AI input (grounding, RAG, AI answers) and AI training are all permitted, with attribution under CC BY 4.0.
New Deep Value Intelligence reports appear most days; the site is rebuilt within 30 minutes of a new report. Use lastmod in the sitemap, dateModified in JSON-LD or the feeds to detect changes; changed pages are also pushed to Bing and other IndexNow engines after every build. The site is static and served with long-lived caching for assets; please keep request rates reasonable.
Licence and citation
Research text is licensed CC BY 4.0. Please cite as DeepValues Research, <title>, <url> and link to the canonical URL. Charts may be reused with the same attribution. Every page's licence line, JSON-LD license, the markdown front matter and the feeds say the same thing.
Educational and research content only, not investment advice.