{"schema_version":"2025-06-18","name":"deep-values","display_name":"Deep Values API","description":"MCP tool manifest for the Deep Values v1 API. Each tool maps to one HTTP endpoint. Point an MCP host at transport.url with a dv_sk_* bearer key; an agent without one mints it itself: POST https://app.deepvalues.ai/api/v1/keys (no account needed). See `onboarding` for the whole loop, including how a 402 is paid.","homepage":"https://app.deepvalues.ai/developers","openapi_url":"https://app.deepvalues.ai/api/v1/openapi.json","pricing_url":"https://app.deepvalues.ai/api/v1/pricing.json","quickstart":[{"step":1,"id":"trial","title":"Keyless trial","body":"No header at all: 25 calls a day per IP across 19 read endpoints (X-RateLimit-Remaining counts down).","curl":"curl -s \"https://app.deepvalues.ai/api/v1/fundamentals/AAPL\""},{"step":2,"id":"key","title":"Mint a key","body":"No account: {\"email\":\"…\"} returns a dv_sk_live_ key holding 1 starter credit; {} returns a never-billed sandbox key. The raw key is shown once.","curl":"curl -s -X POST \"https://app.deepvalues.ai/api/v1/keys\" -H \"Content-Type: application/json\" -d '{\"email\":\"agent@example.com\"}'"},{"step":3,"id":"pay","title":"Pay","body":"A person pays a Stripe link: this returns { checkoutUrl } and the credits land on the key. x402 (USDC paid by the agent itself) is not switched on yet; pricing.json says when it is.","curl":"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\"}'"},{"step":4,"id":"call","title":"Call","body":"Send the key on every call; each 2xx debits its price (https://app.deepvalues.ai/api/v1/pricing.json). 402 = top up, 429 = wait for 00:00 UTC.","curl":"curl -s \"https://app.deepvalues.ai/api/v1/ai-context/AAPL\" -H \"Authorization: Bearer $DV_API_KEY\""}],"onboarding":[{"step":1,"id":"try","title":"Try it with no key","body":["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":"curl -s \"https://app.deepvalues.ai/api/v1/fundamentals/AAPL\""},{"step":2,"id":"key","title":"Get a key","body":["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); 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":"curl -s -X POST \"https://app.deepvalues.ai/api/v1/keys\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\":\"agent@example.com\"}'"},{"step":3,"id":"prices","title":"Prices","body":["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/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":"curl -s \"https://app.deepvalues.ai/api/v1/keys/me\" -H \"Authorization: Bearer $DV_API_KEY\""},{"step":4,"id":"payment","title":"Payment","body":["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 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 the Stripe link."],"curl":"curl -s -X POST \"https://app.deepvalues.ai/api/v1/credits/checkout\" \\\n  -H \"Authorization: Bearer $DV_API_KEY\" -H \"Content-Type: application/json\" \\\n  -d '{\"pack\":\"1000\"}'"},{"step":5,"id":"quotas","title":"Quotas","body":["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`."]}],"transport":{"kind":"streamable-http","url":"https://app.deepvalues.ai/api/mcp","base_url":"https://app.deepvalues.ai/api/v1","auth":{"type":"api_key","scheme":"http_bearer","header":"Authorization","format":"Bearer dv_sk_{live|test}_{32-char-base62}","obtain_key":{"method":"POST","url":"https://app.deepvalues.ai/api/v1/keys","auth":"none","sandbox_body":{},"live_body":{"email":"agent@example.com","label":"optional"},"starter_credits":1,"per_ip_daily_limit":10},"obtain_key_url":"https://app.deepvalues.ai/api/v1/keys","introspect_url":"https://app.deepvalues.ai/api/v1/keys/me","dashboard_url":"https://app.deepvalues.ai/account/api-keys","note":"POST https://app.deepvalues.ai/api/v1/keys needs no account, session or browser. {} returns a dv_sk_test_ sandbox key: real data, never billed, held to a small daily quota, no /research. {\"email\":\"…\"} returns a dv_sk_live_ key on a new prepaid account; the first key for an email carries 1 starter credit. Live keys debit that balance by each endpoint’s `price_credits` per successful call. The email is a contact label, not a login: keep the key, it is the only credential. People can also mint keys from the dashboard."},"pricing":{"model":"metered_pay_per_call","unit":"credit","unit_name":"credit","usd_per_credit":1,"note":"Each endpoint advertises a `price_credits`. One credit is one US dollar, and prices MAY BE FRACTIONAL — most read endpoints cost 0.001 or 0.005 credits — so parse it as a decimal, never as an integer. When metered billing is active, a successful call debits the key owner’s credit balance by that amount (free credits drained before paid). A call that cannot be covered returns HTTP 402 (RFC 7807 problem+json) with a `topUp` object the agent can act on: `checkoutUrl` (a ready Stripe Checkout link) and `checkoutEndpoint` (POST it for any pack). No data is returned and nothing is charged. Endpoints priced at 0 credits are always free. Read the exact balance from `balanceMicro` at balance_url (integer micro-credits, 1 credit = 1,000,000).","balance_url":"https://app.deepvalues.ai/api/v1/keys/me","top_up_url":"https://app.deepvalues.ai/api/v1/credits/checkout","top_up":{"method":"POST","url":"https://app.deepvalues.ai/api/v1/credits/checkout","body":{"pack":"1000"}},"packs":[{"pack":"1000","credits":10},{"pack":"5000","credits":50},{"pack":"20000","credits":200}],"pricing_page_url":"https://app.deepvalues.ai/en/developers#agents-pricing","pricing_json_url":"https://app.deepvalues.ai/api/v1/pricing.json","payment_docs_url":"https://app.deepvalues.ai/llms.txt#payment","rails":{"api_key_credits":{"auth":"dv_sk_* bearer key","settle":"debits the key owner’s credit balance"},"x402":{"enabled":false,"protocol":"x402","versions":[1,2],"scheme":"exact","asset":"USDC","reason":"pay_to_not_configured","flow":"Call a priced endpoint with no Authorization header → HTTP 402 with the quote twice: the base64 PAYMENT-REQUIRED header (x402 v2: { x402Version: 2, resource, accepts:[{ amount, payTo, asset, network }] }) and the JSON body (v1: { x402Version: 1, accepts:[{ maxAmountRequired, … }] }) → sign a USDC transferWithAuthorization for exactly that amount and resend the same request with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) → 200 with the JSON and a PAYMENT-RESPONSE / X-PAYMENT-RESPONSE receipt. No delivery, no charge: settlement only fires on a 2xx result. With a live key, prepay instead: POST https://app.deepvalues.ai/api/v1/credits/top-up?credits=N the same way.","top_up":{"method":"POST","url":"https://app.deepvalues.ai/api/v1/credits/top-up?credits={n}","min_credits":1,"max_credits":500,"auth":"dv_sk_live_ bearer key"}}}}},"tools":[{"name":"deepvalues.keys_create","description":"Mint an API key — no account, session or browser needed","annotations":{"readOnlyHint":false,"title":"Mint an API key — no account, session or browser needed"},"http":{"method":"POST","url_template":"https://app.deepvalues.ai/api/v1/keys","billing_bucket":"metadata","quota_weight":0,"price_credits":0},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.keys_me","description":"This key: exact credit balance, remaining quota, environment","annotations":{"readOnlyHint":true,"title":"This key: exact credit balance, remaining quota, environment"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/keys/me","billing_bucket":"metadata","quota_weight":0,"price_credits":0},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.credits_packs","description":"Credit packs on sale","annotations":{"readOnlyHint":true,"title":"Credit packs on sale"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/credits/checkout","billing_bucket":"metadata","quota_weight":0,"price_credits":0},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.credits_checkout","description":"Get a Stripe Checkout URL that tops up this key’s balance","annotations":{"readOnlyHint":false,"title":"Get a Stripe Checkout URL that tops up this key’s balance"},"http":{"method":"POST","url_template":"https://app.deepvalues.ai/api/v1/credits/checkout","billing_bucket":"metadata","quota_weight":0,"price_credits":0},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.credits_top_up","description":"Buy credits in USDC over x402 — no card, no human","annotations":{"readOnlyHint":false,"title":"Buy credits in USDC over x402 — no card, no human"},"http":{"method":"POST","url_template":"https://app.deepvalues.ai/api/v1/credits/top-up","billing_bucket":"metadata","quota_weight":0,"price_credits":0},"inputSchema":{"type":"object","properties":{"credits":{"type":"integer","minimum":1,"maximum":500,"description":"Whole credits to buy (1 credit = 1 USDC)."}},"required":["credits"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.pricing","description":"Machine-readable price list and the ways to pay","annotations":{"readOnlyHint":true,"title":"Machine-readable price list and the ways to pay"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/pricing","billing_bucket":"metadata","quota_weight":0,"price_credits":0},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.keys_revoke","description":"Revoke this key","annotations":{"readOnlyHint":false,"title":"Revoke this key"},"http":{"method":"DELETE","url_template":"https://app.deepvalues.ai/api/v1/keys/me","billing_bucket":"metadata","quota_weight":0,"price_credits":0},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.account","description":"Account info + current quota usage","annotations":{"readOnlyHint":true,"title":"Account info + current quota usage"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/account","billing_bucket":"metadata","quota_weight":1,"price_credits":0},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.ai_context","description":"Drop-in AI grounding context (DIFFERENTIATED)","annotations":{"readOnlyHint":true,"title":"Drop-in AI grounding context (DIFFERENTIATED)"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/ai-context/{ticker}","billing_bucket":"metadata","quota_weight":3,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"},"token_budget":{"type":"integer","minimum":1000,"maximum":16000,"default":6000}},"required":["ticker"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.research","description":"AI multi-analyst research briefing (HEADLINE)","annotations":{"readOnlyHint":true,"title":"AI multi-analyst research briefing (HEADLINE)"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/research/{ticker}","billing_bucket":"ai_research","quota_weight":1,"price_credits":3},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"},"language":{"type":"string","enum":["English","Chinese"],"default":"English"}},"required":["ticker"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.intrinsic_value","description":"DCF + Owner Earnings + Damodaran intrinsic value","annotations":{"readOnlyHint":true,"title":"DCF + Owner Earnings + Damodaran intrinsic value"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/intrinsic-value/{ticker}","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"}},"required":["ticker"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.smart_money_holdings","description":"Which curated gurus hold this ticker","annotations":{"readOnlyHint":true,"title":"Which curated gurus hold this ticker"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/smart-money/holdings","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string","pattern":"^[A-Z]{1,5}([.-][A-Z]{1,2})?$"},"quarter_end":{"type":"string","format":"date","description":"ISO date; default = latest available"}},"required":["ticker"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.smart_money_changes","description":"Material guru moves in a time window","annotations":{"readOnlyHint":true,"title":"Material guru moves in a time window"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/smart-money/changes","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"since":{"type":"string","description":"ISO date OR YYYY-QN format. Filters on the QUARTER a position belongs to (quarter_end), not on when it was filed."},"filed_since":{"type":"string","format":"date","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"},"status":{"type":"string","enum":["new","added","trimmed","exited"]}},"required":["since"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.guru_moves","description":"Material guru moves, newest filing first, each with its verdict","annotations":{"readOnlyHint":true,"title":"Material guru moves, newest filing first, each with its verdict"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/gurus/moves","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"filed_since":{"type":"string","format":"date","description":"Only moves filed on or after this date. Poll with it."},"slugs":{"type":"string","description":"Comma-separated guru slugs; default is every guru."},"limit":{"type":"integer","maximum":200,"default":50}},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.verdict","description":"The verdict line for one filed move","annotations":{"readOnlyHint":true,"title":"The verdict line for one filed move"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/verdict/{ticker}","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"},"guru":{"type":"string"},"quarter":{"type":"string","format":"date","description":"Quarter end; default = the most recent quarter we hold."}},"required":["ticker","guru"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.mirror_brief","description":"An impersonal brief on one filed move, for an agent to act on","annotations":{"readOnlyHint":true,"title":"An impersonal brief on one filed move, for an agent to act on"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/mirror-brief/{ticker}","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"},"guru":{"type":"string"},"quarter":{"type":"string","format":"date"}},"required":["ticker","guru"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.gurus","description":"Curated guru roster","annotations":{"readOnlyHint":true,"title":"Curated guru roster"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/gurus","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"style":{"type":"string","enum":["value","growth","activist","macro","quant"]},"limit":{"type":"integer","maximum":200,"default":100}},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.guru","description":"One guru: bio + top holdings","annotations":{"readOnlyHint":true,"title":"One guru: bio + top holdings"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/gurus/{slug}","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.guru_portfolio","description":"One guru's full portfolio at a quarter","annotations":{"readOnlyHint":true,"title":"One guru's full portfolio at a quarter"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/gurus/{slug}/portfolio","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"slug":{"type":"string"},"as_of":{"type":"string","format":"date"}},"required":["slug"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.theses","description":"Structured human investment theses","annotations":{"readOnlyHint":true,"title":"Structured human investment theses"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/theses","billing_bucket":"metadata","quota_weight":1,"price_credits":0.005},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"},"min_conviction":{"type":"integer","minimum":1,"maximum":5},"sentiment":{"type":"string","enum":["bullish","bearish","neutral"]},"limit":{"type":"integer","maximum":200,"default":50}},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.indicators_buffett","description":"Buffett Indicator with zone classification","annotations":{"readOnlyHint":true,"title":"Buffett Indicator with zone classification"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/indicators/buffett","billing_bucket":"metadata","quota_weight":1,"price_credits":0.001},"inputSchema":{"type":"object","properties":{"history_years":{"type":"integer","maximum":50,"default":5}},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.indicators_shiller_pe","description":"Shiller PE with historical percentile","annotations":{"readOnlyHint":true,"title":"Shiller PE with historical percentile"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/indicators/shiller-pe","billing_bucket":"metadata","quota_weight":1,"price_credits":0.001},"inputSchema":{"type":"object","properties":{"history_years":{"type":"integer","maximum":100,"default":5}},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.sentiment","description":"Value-investor sentiment rollup (not WSB noise)","annotations":{"readOnlyHint":true,"title":"Value-investor sentiment rollup (not WSB noise)"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/sentiment/{ticker}","billing_bucket":"metadata","quota_weight":1,"price_credits":0.001},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"},"source":{"type":"string","enum":["reddit","stocktwits","combined"],"default":"combined"},"window":{"type":"string","enum":["24h","7d","30d"],"default":"7d"}},"required":["ticker"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.news","description":"Sentiment-scored news","annotations":{"readOnlyHint":true,"title":"Sentiment-scored news"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/news/{ticker}","billing_bucket":"metadata","quota_weight":1,"price_credits":0.001},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"},"since":{"type":"string","format":"date"},"sentiment":{"type":"string","enum":["bullish","bearish","neutral"]}},"required":["ticker"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.companies_search","description":"Company search","annotations":{"readOnlyHint":true,"title":"Company search"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/companies","billing_bucket":"metadata","quota_weight":1,"price_credits":0.001},"inputSchema":{"type":"object","properties":{"q":{"type":"string"},"limit":{"type":"integer","maximum":100,"default":20}},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.company_overview","description":"Company overview","annotations":{"readOnlyHint":true,"title":"Company overview"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/companies/{ticker}/overview","billing_bucket":"metadata","quota_weight":1,"price_credits":0.001},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"}},"required":["ticker"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.fundamentals","description":"Income + balance + cashflow","annotations":{"readOnlyHint":true,"title":"Income + balance + cashflow"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/fundamentals/{ticker}","billing_bucket":"metadata","quota_weight":1,"price_credits":0.001},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"},"period":{"type":"string","enum":["annual","quarterly"],"default":"annual"},"limit":{"type":"integer","maximum":20,"default":5}},"required":["ticker"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.filings","description":"SEC filings (10-K, 10-Q, 8-K, etc)","annotations":{"readOnlyHint":true,"title":"SEC filings (10-K, 10-Q, 8-K, etc)"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/filings/{ticker}","billing_bucket":"metadata","quota_weight":1,"price_credits":0.001},"inputSchema":{"type":"object","properties":{"ticker":{"type":"string"},"form":{"type":"string"},"limit":{"type":"integer","maximum":50,"default":10}},"required":["ticker"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.webhooks_list","description":"List webhook subscriptions","annotations":{"readOnlyHint":true,"title":"List webhook subscriptions"},"http":{"method":"GET","url_template":"https://app.deepvalues.ai/api/v1/webhooks","billing_bucket":"metadata","quota_weight":1,"price_credits":0},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.webhooks_create","description":"Create webhook subscription","annotations":{"readOnlyHint":false,"title":"Create webhook subscription"},"http":{"method":"POST","url_template":"https://app.deepvalues.ai/api/v1/webhooks","billing_bucket":"metadata","quota_weight":1,"price_credits":0},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.webhooks_delete","description":"Delete a webhook subscription","annotations":{"readOnlyHint":false,"title":"Delete a webhook subscription"},"http":{"method":"DELETE","url_template":"https://app.deepvalues.ai/api/v1/webhooks/{id}","billing_bucket":"metadata","quota_weight":1,"price_credits":0},"inputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}},{"name":"deepvalues.webhooks_test","description":"Send a test delivery to a webhook subscription","annotations":{"readOnlyHint":false,"title":"Send a test delivery to a webhook subscription"},"http":{"method":"POST","url_template":"https://app.deepvalues.ai/api/v1/webhooks/{id}/test","billing_bucket":"webhook_events","quota_weight":1,"price_credits":0},"inputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"],"additionalProperties":false},"output":{"content_type":"application/json","note":"Returns the endpoint JSON on success, or an RFC 7807 application/problem+json error envelope (branch on `type`)."}}],"disclaimer":"Deep Values sells data and analysis, not investment advice. Outputs are informational and sourced from SEC EDGAR, 13F filings, FRED, and the Deep Values multi-analyst research pipeline; they are not a recommendation to buy or sell any security."}