# SperaxOS Country Intelligence API

> SperaxOS Country Intelligence API is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-02).

Returns AI-generated geopolitical and stability intelligence for a given country, including risk scores, unrest signals, security components, and headline citations, payable via x402 USDC on Base.

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/hq/country-intel?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-country-intelligence-api-31f88dda
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3sQP3hK2PX1ZmxWOdSIlZ

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-country-intelligence-api-31f88dda -d '<json body>'
```

Example prompt: Give me a full country intelligence briefing for Brazil — the risk level is 'elevated', score 67, trend is worsening, there have been 3 outages, 12 protests, and these headlines: ['Protests erupt in São Paulo', 'Military on standby amid unrest', 'Markets drop 2.4%']. Unrest component is 0.7, security 0.6, information 0.5.

## When to prefer this

Use this endpoint when you need an AI-synthesized narrative country intelligence report that integrates heterogeneous signals (protests, outages, military activity, headlines, component scores) into a coherent geopolitical assessment. Prefer it over raw data feeds when you need cited, scored, and trend-aware analysis for DeFi risk decisions, investment screening, or crisis monitoring — and when you want to pay per request with USDC via x402 without managing API keys.

## Known failure modes

- Missing or invalid country code causes cache miss or processing error
- Malformed context object with wrong field types returns a validation error
- Payment not included or insufficient USDC triggers HTTP 402 response requiring x402 payment
- Excessive headline count beyond 15 may result in truncation of citations
- Empty or null context object may yield a generic or low-confidence intelligence output

## 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

An AI-generated country intelligence report synthesizing the provided signals — risk level, score, trend, outage/protest/earthquake counts, military activity, stock index context, regional convergence signals, and up to 15 cited headlines — into a structured geopolitical and stability assessment with component breakdowns (unrest, security, information).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "code": {
   "type": "string",
   "description": "country code, used as cache key"
  },
  "context": {
   "type": "object",
   "properties": {
    "level": {
     "type": "string"
    },
    "score": {
     "type": "number"
    },
    "trend": {
     "type": "string"
    },
    "outages": {
     "type": "integer"
    },
    "protests": {
     "type": "integer"
    },
    "change24h": {
     "type": "number"
    },
    "headlines": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "first 15 used, cited as [N]"
    },
    "components": {
     "type": "object",
     "properties": {
      "unrest": {
       "type": "number"
      },
      "security": {
       "type": "number"
      },
      "information": {
       "type": "number"
      }
     }
    },
    "stockIndex": {
     "type": "string"
    },
    "earthquakes": {
     "type": "integer"
    },
    "signalTypes": {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    "militaryFlights": {
     "type": "integer"
    },
    "militaryVessels": {
     "type": "integer"
    },
    "convergenceScore": {
     "type": "number"
    },
    "regionalConvergence": {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   },
   "additionalProperties": true
  },
  "country": {
   "type": "string",
   "description": "country display name"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-country-intelligence-api-31f88dda/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)