# x402stock Historical Dividends by Ticker

> x402stock Historical Dividends by Ticker is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-09).

Returns historical cash dividend records for a US-listed ticker, including amount, currency, type, frequency, and all key dates (declaration, ex-dividend, record, pay), sorted most recent first.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/dividends/{ticker}
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-09
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-historical-dividends-by-ticker-07b4073e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-FGavJ6mm9YB8HPHz4_wr

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 agents-x402stock-xyz-x402stock-historical-dividends-by-ticker-07b4073e
```

Example prompt: Pull the last 20 dividend payments for KO — I want the cash amount, ex-dividend date, pay date, and whether they were regular or special dividends.

## When to prefer this

Use this endpoint when you need structured historical dividend data for a specific US-listed stock or ETF, including exact dates and amounts for income analysis, ex-dividend qualification checks, or dividend growth trend research. Prefer this over general financial data APIs when you need pay-per-call pricing with no API key setup, or when building autonomous agent workflows that only pay for the data actually consumed.

## Known failure modes

- Invalid or non-US ticker symbol returns an empty data array or error response
- Ticker with no dividend history returns count: 0 and an empty dividends array
- Limit parameter of 0 or negative integer rejected (exclusiveMinimum: 0)
- Limit above 1000 rejected by schema validation
- Payment failure via x402 results in 402 response before data is returned
- Network timeout for illiquid or obscure tickers with sparse data

## How this service works

Historical cash dividends for a ticker: amount, currency, type, frequency, and the declaration / ex-dividend / record / pay dates. Most recent first. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.

## Output

A JSON object containing the ticker, a count of returned records, and an array of dividend entries sorted most recent first. Each entry includes: cash_amount (float), currency (string or null), dividend_type (e.g. 'CD' for regular cash, 'SC' for special cash, or null), frequency (number of payments per year or null), declaration_date, ex_dividend_date, record_date, and pay_date (all ISO date strings or null). Also includes an as_of timestamp and source attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 1000,
   "exclusiveMinimum": 0
  },
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker",
  "data",
  "source",
  "as_of"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "count",
    "dividends"
   ],
   "properties": {
    "count": {
     "type": "number"
    },
    "dividends": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "cash_amount",
       "currency",
       "dividend_type",
       "frequency",
       "declaration_date",
       "ex_dividend_date",
       "record_date",
       "pay_date"
      ],
      "properties": {
       "currency": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "pay_date": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "frequency": {
        "anyOf": [
         {
          "type": "number"
         },
         {
          "type": "null"
         }
        ]
       },
       "cash_amount": {
        "type": "number"
       },
       "record_date": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "dividend_type": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "declaration_date": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "ex_dividend_date": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       }
      },
      "additionalProperties": false
     }
    }
   },
   "additionalProperties": false
  },
  "as_of": {
   "type": "string"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "ticker": {
   "type": "string"
  },
  "feedback": {
   "type": "object",
   "required": [
    "endpoint",
    "method",
    "free",
    "note"
   ],
   "properties": {
    "free": {
     "type": "boolean"
    },
    "note": {
     "type": "string"
    },
    "method": {
     "type": "string",
     "const": "POST"
    },
    "endpoint": {
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-historical-dividends-by-ticker-07b4073e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)