# Market Intelligence API – US Stock Dividend Profile

> Market Intelligence API – US Stock Dividend Profile is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns quarterly dividends declared per share from SEC XBRL filings, trailing four-quarter total, year-over-year growth, and trailing yield for a US stock ticker.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/sec/dividends/:symbol?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-intelligence-api-us-stock-dividend-profile-b2b38668
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wMiyCaT0p6NAf4KLsBQID

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 market-intelligence-api-us-stock-dividend-profile-b2b38668
```

Example prompt: What's the current dividend yield for KO, and how has its quarterly dividend per share changed year over year according to SEC filings?

## When to prefer this

Use this endpoint when you need authoritative, SEC XBRL-sourced dividend data for a US-listed stock, including quarterly history, trailing totals, growth rates, and yield. Prefer this over scraped or estimated dividend sources when accuracy and regulatory provenance matter, such as for portfolio income analysis, dividend screening, or pre-trade research on income-generating equities.

## Known failure modes

- 404 Not Found – ticker is not recognized or has no SEC XBRL filings; call is not charged
- Invalid or malformed ticker symbol in path parameter
- Ticker exists but has never declared dividends (zero-dividend stock)
- Stale SEC data if the company has not yet filed its latest quarterly report
- Network timeout or upstream SEC data provider unavailability

## How this service works

Dividend history and yield of a US stock: quarterly dividends declared per share from SEC XBRL filings, the trailing four-quarter total, year-over-year growth and the trailing yield at the current price. Use for a dividend profile.

## Output

A JSON object containing: the per-quarter dividends declared per share sourced from SEC XBRL filings, the trailing four-quarter dividend total, year-over-year dividend growth rate, and the trailing yield calculated at the current stock price. If the ticker is unknown or has no SEC filings, a 404 is returned and the call is not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "examples": [
        "AAPL"
       ],
       "description": "Any US ticker with SEC filings (about 10,000, e.g. AAPL, KO, JPM), not only the example. Unknown: 404, not charged."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "description": "Example JSON response returned by this endpoint"
    }
   },
   "additionalProperties": true
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-us-stock-dividend-profile-b2b38668/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.marketintelligenceapi.com](https://www.zero.xyz/host/api.marketintelligenceapi.com/llms.txt)