# ADH Countries Master — ISO Country Reference Data

> ADH Countries Master — ISO Country Reference Data is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Returns a master list of all ~250 countries with ISO codes, currencies, borders, geography, languages, and UN membership status

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/countries-master?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adh-countries-master-iso-country-reference-data-cd0cf0f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HanH6yAet2g1dobWvIyNV

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 adh-countries-master-iso-country-reference-data-cd0cf0f5
```

Example prompt: Pull the full countries master list — I need ISO alpha-2 and alpha-3 codes, capital cities, currencies, borders, and languages for all 250 countries so I can populate our reference database.

## When to prefer this

Choose this endpoint when you need a comprehensive, all-in-one country reference dataset with ISO codes, currencies, borders, languages, and geo-coordinates in a single call. It is a direct replacement for the deprecated restcountries v3.1 API and suits agents that pay per-call via x402 USDC micropayments rather than maintaining an API subscription. Prefer it over building your own scraper or maintaining a static CSV when freshness and entity resolution matter.

## Known failure modes

- Payment failure (402): x402 micropayment not settled — agent must complete USDC payment flow before data is returned
- Rate limiting or quota exceeded if called in rapid succession
- Stale data: collected_at timestamp may lag real-world geopolitical changes (e.g. newly recognized states)
- Empty or partial response if upstream dataset source is unavailable

## How this service works

ADH 金融情报层：把 239 个原始数据源洗成带实体解析、时间同步、溯源与派生结论的情报（宏观regime / 加密尽调 / 事件窗口），免费注入你的 AI 上下文。Agent 走 x402 结算，人类订阅（PayPal）即将上线。

## Output

A JSON object containing an array of ~250 country records, each with fields: tld, cca2, cca3, name, official_name, latlng, region, subregion, borders (array of neighboring country codes), capital, area_km2, unMember (boolean), languages (array), currencies (array), landlocked (boolean). Also includes a top-level count field and source/collection metadata. Sourced from mledoze/countries and positioned as a drop-in replacement for the deprecated restcountries v3.1 API.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "data": [
    {
     "tld": ".aw",
     "cca2": "AW",
     "cca3": "ABW",
     "name": "Aruba",
     "latlng": [
      12.5,
      12.5
     ],
     "region": "Americas",
     "borders": [],
     "capital": "Oranjestad",
     "area_km2": 180,
     "unMember": false,
     "languages": [
      "Dutch",
      "Dutch"
     ],
     "subregion": "Caribbean",
     "currencies": [
      "AWG"
     ],
     "landlocked": false,
     "official_name": "Aruba"
    },
    {
     "tld": ".aw",
     "cca2": "AW",
     "cca3": "ABW",
     "name": "Aruba",
     "latlng": [
      12.5,
      12.5
     ],
     "region": "Americas",
     "borders": [],
     "capital": "Oranjestad",
     "area_km2": 180,
     "unMember": false,
     "languages": [
      "Dutch",
      "Dutch"
     ],
     "subregion": "Caribbean",
     "currencies": [
      "AWG"
     ],
     "landlocked": false,
     "official_name": "Aruba"
    }
   ],
   "countries": 250
  },
  "note": "Replaces the deprecated restcountries v3.1 API; ISO codes, currencies, borders, geo.",
  "source": "mledoze/countries",
  "data_type": "地理",
  "collected_at": "2026-08-09T18:40:48Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adh-countries-master-iso-country-reference-data-cd0cf0f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)