{"uid":"cap__PQ23o-5UY_2T8Lk9LEng","slug":"prereason-company-financial-briefing-api-591264f3","name":"PreReason Company Financial Briefing API","description":"Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin. One API call returns a briefing with the reasoning already in it.","url":"https://api.prereason.com/api/companies/%7Bcompany%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["company"],"properties":{"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."},"company":{"type":"string","pattern":"^[A-Za-z0-9.-]{1,33}$","description":"The company. A USA ticker or CIK (NVDA), a Japanese securities code (7203), a Korean stock code (005930) or an Indian company's ISIN (INE018A01030). Case does not matter."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"entity":{"templateVersion":"company.v1@4"},"briefing_used":"equities.company/nvda"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.35","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.35/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c1U3axzQLfNUEvWzUVz9k","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.35","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a pre-reasoned financial briefing for a listed company (US, Japanese, Korean, or Indian) including latest reported figures, macro context, and market analysis.","exampleAgentPrompt":"Pull me a full PreReason financial briefing for NVDA — latest figures, what changed, and the macro context — formatted as markdown so I can use it directly.","exampleUseCases":[{"title":"Equity research brief for earnings prep","prompt":"Get me the PreReason company briefing for AAPL in markdown format — I need the latest reported figures and what's changed before their earnings call."},{"title":"Cross-border stock due diligence","prompt":"Fetch the PreReason financial briefing for Toyota using its Japanese securities code 7203 — I want the macro context and latest numbers in JSON format."},{"title":"AI agent market context enrichment","prompt":"Grab the PreReason briefing for Samsung using stock code 005930 and give it to me in markdown so my agent can reason about its current financial position."}],"resultDescription":"A structured financial briefing for the requested company, including latest reported financial figures, what has changed, macro and rates context relevant to the company, and pre-written reasoning narrative. Available in markdown (token-optimized for LLMs) or JSON (structured) format. The response includes entity metadata and a briefing identifier indicating which template version was used.","failureModes":["Invalid or unrecognized ticker/ISIN/stock code returns an error — ensure the company identifier matches the pattern ^[A-Za-z0-9.-]{1,33}$","Company not covered by PreReason's database returns a 404 or empty briefing","Payment failure (402) if x402 payment header is missing or insufficient — endpoint costs $0.35 USDC per call","Stale data if the underlying market data source hasn't updated recently","Invalid format parameter (not 'json' or 'markdown') may result in a default or error response"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, pre-reasoned financial briefing for a specific listed company — especially when feeding context to an AI agent that needs structured analysis without performing its own multi-step reasoning. It supports US tickers, CIKs, Japanese securities codes, Korean stock codes, and Indian ISINs, making it ideal for cross-border equity research. Prefer this over raw financial data APIs when you want reasoning already embedded in the output, saving token budget and agent reasoning steps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:44:56.509Z","isFirstParty":false,"canonicalSlug":"prereason-company-financial-briefing-api-591264f3"}