{"uid":"cap_3Qn5RyGYbeYw3NKls21m2","slug":"you-com-finance-research-api-715e4931","name":"You.com Finance Research API","description":"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).","url":"https://api.you.com/v1/finance_research?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.11","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"11.0000","medianCents":"11.0000","p90Cents":"11.0000","minCents":"11.0000","maxCents":"11.0000","p95Cents":"11.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.11/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.11","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.11","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wCfIq7vJfCVmpYBJooxgP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.11","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs agentic deep research on a financial question and returns a synthesized, cited answer suitable for trading or investment decisions","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-trade company analysis","prompt":"Run a deep research on Nvidia's earnings outlook for the next two quarters — I want a synthesized take with cited sources before I make a trade decision."},{"title":"Sector macro trend investigation","prompt":"I need exhaustive research on how rising interest rates are affecting the US commercial real estate sector right now, with cited sources."},{"title":"Investment risk assessment","prompt":"Do standard-depth research on the key risks facing Alibaba as a long-term investment given current regulatory and geopolitical pressures — summarize the findings with sources."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-10-08T20:30:50.936Z","lastSuccessfullyRanAt":"2026-10-08T20:30:50.936Z","lastHealthCheckAt":"2026-10-12T21:00:03.033Z","isFirstParty":false,"canonicalSlug":"you-com-finance-research-api-715e4931"}