# You.com Finance Research API

> You.com Finance Research API is a paid API for AI agents from api.you.com, paid per call via x402, $0.11/call, status healthy (last checked 2026-10-12, last successful call 2026-10-08).

Performs agentic deep research on a financial question and returns a synthesized, cited answer suitable for trading or investment decisions

## Facts

- Endpoint: POST https://api.you.com/v1/finance_research?utm_source=zero.xyz
- Price: $0.11/call
- Payment: x402
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-10-08
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/you-com-finance-research-api-715e4931
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3Qn5RyGYbeYw3NKls21m2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability you-com-finance-research-api-715e4931 -d '<json body>'
```

Example prompt: Do an exhaustive deep research on Tesla's competitive position in the EV market right now — I need a well-reasoned synthesis with sources before I decide whether to add to my position.

## When to prefer this

Choose this endpoint when an agent needs a well-reasoned, synthesized analysis of a financial topic — not just raw search results — with cited sources to support trading or investment decisions. It excels over generic web search when the task requires aggregating and reasoning across multiple sources rather than simple lookup. Prefer the 'exhaustive' effort level for major decisions and 'standard' for quick background checks.

## Known failure modes

- Invalid or missing 'input' field returns a 400 error
- Unrecognized 'research_effort' value may default or error
- Payment failure (insufficient USDC or bad x402 auth) prevents job creation
- Job not yet complete when polling returns a pending/in-progress status
- Network timeout during long polling window for exhaustive research
- Rate limiting or quota exceeded returns a 429 error

## How this service works

You.com Finance Research API: agentic deep research on a financial question, returning a synthesized answer with cited sources. Use when an agent needs well-reasoned market or company analysis for a trading or investment decision. JSON body: input (required question), research_effort (standard | deep | exhaustive, default deep). Paid per call in USDC. Async: paying returns a jobId; poll the SIWX-authed poll_url for the result (deep research takes 1-3 min).

## Output

An async job is created upon payment; polling the provided poll_url returns a synthesized, well-reasoned answer to the financial question along with cited sources. Deep research typically takes 1–3 minutes to complete.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "input"
     ],
     "properties": {
      "input": {
       "type": "string",
       "maxLength": 40000,
       "description": "The finance research question."
      },
      "research_effort": {
       "enum": [
        "standard",
        "deep",
        "exhaustive"
       ],
       "type": "string",
       "default": "deep",
       "description": "Research depth. Higher effort costs more per call: standard, deep, exhaustive."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/you-com-finance-research-api-715e4931/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.you.com](https://www.zero.xyz/host/api.you.com/llms.txt)