# OnchainExpat Clubs Changes API

> OnchainExpat Clubs Changes API is a paid API for AI agents from x402.onchainexpat.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-16).

Returns recent changes to clubs (organizations/venues) with optional filtering by country and time window

## Facts

- Endpoint: POST https://x402.onchainexpat.com/api/x402/clubs/changes?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onchainexpat-clubs-changes-api-aa72885a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1hTk-wO-PQAkduwzvIP8e

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 onchainexpat-clubs-changes-api-aa72885a -d '<json body>'
```

Example prompt: Pull the latest club changes from OnchainExpat since July 1, 2026, limiting results to 500 records and filtering to clubs in Spain.

## When to prefer this

Use this endpoint when you need to track incremental changes to club data over time, especially for syncing a local database, monitoring new additions, or building change-aware workflows scoped to a country. Prefer it over a full-catalog fetch when you only care about what changed since a known date.

## Known failure modes

- Invalid ISO date format for 'since' parameter returns a 400 error
- Unknown country slug returns empty results or a 400 error
- Limit exceeding 5000 is rejected or clamped
- Payment not included or insufficient USDC triggers x402 payment-required response
- Empty response if no clubs changed within the specified window
- Timeout or 5xx if backend data source is unavailable

## How this service works

Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol

## Output

A JSON array or object containing club change records, each representing a club that was added, modified, or removed within the specified time window. Records may include club identifiers, names, country slugs, timestamps, and change details. Results are filtered by country and bounded by the since date and limit parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "since"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max results (default: 1000, max: 5000)"
  },
  "since": {
   "type": "string",
   "description": "ISO date or timestamp, e.g., '2026-07-01'"
  },
  "country": {
   "type": "string",
   "description": "Restrict to one country slug"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "clubs": {
   "type": "array",
   "description": "Each with a change field of 'added' or 'updated', plus created_at and updated_at"
  },
  "count": {
   "type": "integer"
  },
  "since": {
   "type": "string"
  },
  "total": {
   "type": "integer"
  },
  "change_tracking_started": {
   "type": "string",
   "description": "Date from which 'updated' is meaningful; 'added' covers full history"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onchainexpat-clubs-changes-api-aa72885a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.onchainexpat.com](https://www.zero.xyz/host/x402.onchainexpat.com/llms.txt)