# SperaxOS GDELT Document Search API

> SperaxOS GDELT Document Search API is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Queries the GDELT Project's document database for global news and event-driven intelligence, payable per-request via x402/USDC

## Facts

- Endpoint: GET https://chat.sperax.io/api/x402/gdelt-doc?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-gdelt-document-search-api-9716c5a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BVR4aYXiHBmuKrzXLQcWo

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 speraxos-gdelt-document-search-api-9716c5a0
```

Example prompt: Search GDELT news documents for recent global media coverage of Uniswap protocol governance — I want to see what the press has been saying about it in the last week.

## When to prefer this

Choose this endpoint when you need real-time global news intelligence from the GDELT document database specifically for DeFi or crypto research, without needing to set up an API key. It is ideal for AI agents that want pay-per-use news retrieval payable in USDC on Base, and particularly useful when correlating media narratives with on-chain DeFi events or market movements.

## Known failure modes

- Payment not included or insufficient USDC balance returns 402 Payment Required
- Malformed query parameters return 400 Bad Request
- GDELT upstream unavailability returns 503 or timeout
- Rate limiting if too many requests are sent in short succession
- Empty result set if query terms have no GDELT document matches

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

Returns GDELT document search results including news article metadata, URLs, publication dates, themes, sentiment signals, and event-linked coverage relevant to the query — enabling AI-driven analysis of global media narratives around DeFi and crypto topics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-gdelt-document-search-api-9716c5a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)