# x402stock Dividends API

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

Returns historical and upcoming dividend records for a given US stock or ETF ticker, paid per-call in USDC via x402 on Base.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/dividends/%7Bticker%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-dividends-api-5cc2a2a9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_es_2Z1WpE2wJgq5zkZrM0

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 x402stock-dividends-api-5cc2a2a9
```

Example prompt: Pull the last 10 dividend payments for AAPL — I want to see the cash amount, ex-dividend date, pay date, and how frequently they pay.

## When to prefer this

Use this endpoint when you need structured, per-ticker dividend history or upcoming payment schedules for US stocks and ETFs, especially in a no-account, pay-per-call context with USDC via x402 on Base. Prefer this over broker APIs when you need lightweight, agent-friendly access without API key management.

## Known failure modes

- Invalid or unknown ticker returns empty dividend array or 404
- Payment failure via x402 (insufficient USDC balance) results in 402 Payment Required
- limit parameter out of range (<=0 or >1000) returns 400 validation error
- Network or upstream data provider outage results in 5xx error
- Ticker with no dividend history returns count of 0 and empty dividends array

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing the ticker symbol, a data-as-of timestamp, and an array of dividend records. Each record includes cash_amount, currency, dividend_type (e.g. 'CD' for cash dividend), frequency (e.g. 4 for quarterly), declaration_date, ex_dividend_date, record_date, and pay_date.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "limit"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 1000,
       "exclusiveMinimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "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"
             },
             {
              "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 1,
   "dividends": [
    {
     "currency": "USD",
     "pay_date": "2026-05-14",
     "frequency": 4,
     "cash_amount": 0.27,
     "record_date": "2026-05-11",
     "dividend_type": "CD",
     "declaration_date": "2026-04-30",
     "ex_dividend_date": "2026-05-11"
    }
   ]
  },
  "as_of": "2026-05-29T20:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-dividends-api-5cc2a2a9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)