# PreReason Company Financial Briefing Block API

> PreReason Company Financial Briefing Block API is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Returns a specific block of AI-ready financial briefing data for a given company, including numbers, valuation, segments, news, and more

## Facts

- Endpoint: GET https://api.prereason.com/api/companies/%7Bcompany%7D/%7Bblock%7D?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prereason-company-financial-briefing-block-api-73235ac7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XufBW8UFWrdVl3jxjqkf0

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 prereason-company-financial-briefing-block-api-73235ac7
```

Example prompt: Pull the valuation block for NVDA from PreReason so I can see how Nvidia is priced relative to its fundamentals right now.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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"
   ],
   "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "block": {
   "block": "numbers"
  },
  "briefing_used": "equities.company/nvda"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-company-financial-briefing-block-api-73235ac7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.prereason.com](https://www.zero.xyz/host/api.prereason.com/llms.txt)