{"uid":"cap_XufBW8UFWrdVl3jxjqkf0","slug":"prereason-company-financial-briefing-block-api-73235ac7","name":"PreReason Company Financial Briefing Block 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/%7Bblock%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","block"],"properties":{"block":{"enum":["header","what_changed","situations","against_guidance","numbers","segments","valuation","capital_structure","quality","profitability","news"],"type":"string","description":"The block of the company briefing to return."},"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":{"block":{"block":"numbers"},"briefing_used":"equities.company/nvda"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_u9wXjVMFULqBDfQEkfB8u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a specific block of AI-ready financial briefing data for a given company, including numbers, valuation, segments, news, and more","exampleAgentPrompt":"Pull the valuation block for NVDA from PreReason so I can see how Nvidia is priced relative to its fundamentals right now.","exampleUseCases":[{"title":"Earnings call prep for TSMC","prompt":"Get me the numbers block for TSM from PreReason — I want the key financial figures before the earnings call."},{"title":"Checking if Apple is beating guidance","prompt":"Pull the against_guidance block for AAPL so I can see whether Apple is tracking ahead or behind its own forecasts."},{"title":"Segmental breakdown of Samsung","prompt":"Fetch the segments block for Samsung using its Korean stock code 005930 — I want to understand which business lines are driving revenue."}],"resultDescription":"A structured or markdown-formatted briefing block for the requested company, covering the specific aspect requested (e.g. headline summary, what changed, key numbers, valuation multiples, segment breakdown, guidance comparison, capital structure, quality, profitability, or recent news). The response includes the block type and the briefing identifier used. Markdown format is token-optimized for LLM consumption.","failureModes":["Unknown or unsupported ticker/code returns an error or empty result","Invalid block enum value causes a validation error","Payment not completed (x402 flow) results in 402 response before data is returned","Rate limiting or quota exhaustion returns an error","Company data not yet available for a given identifier returns no briefing"],"whenToPreferThis":"Choose this endpoint when you need AI-ready, pre-reasoned financial context for a specific public company on a specific dimension (numbers, valuation, news, etc.) without having to aggregate raw data yourself. It is especially useful for agents that need to quickly enrich a conversation with company fundamentals, support investment research workflows, or feed downstream LLM reasoning with structured financial context. Prefer it over raw financial data APIs when token efficiency and pre-synthesized reasoning matter. Supports US, Japanese, Korean, and Indian equities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:45:34.449Z","isFirstParty":false,"canonicalSlug":"prereason-company-financial-briefing-block-api-73235ac7"}