# Alpaca Corporate Actions API (via claw402 x402 Gateway)

> Alpaca Corporate Actions API (via claw402 x402 Gateway) is a paid API for AI agents from claw402.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Retrieves corporate actions data (dividends, splits, mergers, etc.) for specified stock symbols via Alpaca Markets, accessible with USDC micropayment instead of API keys.

## Facts

- Endpoint: GET https://claw402.ai/api/v1/alpaca/corporate-actions
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/alpaca-corporate-actions-api-via-claw402-x402-gateway-e7e667dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vtZJ7VvI_vk8TbBJqJQuG

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 alpaca-corporate-actions-api-via-claw402-x402-gateway-e7e667dd
```

Example prompt: Can you pull all corporate actions for AAPL and TSLA from January 1 2024 to June 30 2024, sorted by date, and show me any dividends or splits that occurred?

## When to prefer this

Prefer this endpoint when you need corporate actions data (dividends, splits, mergers, spin-offs) for specific stock symbols and want to pay per-call with USDC without managing Alpaca API keys or subscriptions. Ideal for low-frequency, ad-hoc queries where a full Alpaca brokerage account setup is not desired.

## Known failure modes

- Empty data array returned when no corporate actions match the query parameters
- Invalid symbol returns empty results or error code
- Invalid date format in start/end parameters causes request failure
- Unsupported action type in types parameter returns no results
- USDC payment failure results in HTTP 402 response blocking the request
- Rate limiting or upstream Alpaca API unavailability returns error

## How this service works

Backed by vergex.trade. Pay for any API with USDC. No API keys. No registration. Just a wallet.

## Output

Returns a JSON object with a status code and a data array containing corporate action records for the requested symbols, filtered by the specified date range and action types. Each record includes details such as action type, effective date, and symbol-specific information.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "end": {
       "type": "string"
      },
      "sort": {
       "type": "string"
      },
      "limit": {
       "type": "string"
      },
      "start": {
       "type": "string"
      },
      "types": {
       "type": "string"
      },
      "symbols": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 0,
  "data": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alpaca-corporate-actions-api-via-claw402-x402-gateway-e7e667dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from claw402.ai](https://www.zero.xyz/host/claw402.ai/llms.txt)