# Country Facts Lookup (Capital, Currencies, Languages, Population, Timezones, Calling Code)

> Country Facts Lookup (Capital, Currencies, Languages, Population, Timezones, Calling Code) is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Returns key country facts — capital city, currencies, official languages, population, timezones, and calling code — for any country identified by ISO code or name.

## Facts

- Endpoint: POST https://twin.unykorn.org/geo/country?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/country-facts-lookup-capital-currencies-languages-population-7d4475e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X_EZ4oNF9j1wI0gJUImWg

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 country-facts-lookup-capital-currencies-languages-population-7d4475e3 -d '<json body>'
```

Example prompt: What's the capital, official languages, currency, population, timezones, and calling code for Japan?

## When to prefer this

Use this endpoint when an agent needs a quick, structured bundle of standard country metadata (capital, currency, language, population, timezone, calling code) without needing to query multiple geocoding or demographic APIs separately. Ideal for enriching user inputs with country context, powering travel or business briefing flows, or answering geography questions in a single call. Prefer this over general-purpose geocoding APIs when the required output is country-level facts rather than coordinates or addresses.

## Known failure modes

- Unrecognized or misspelled country name returns an error or empty result
- Ambiguous short names (e.g. 'Congo') may resolve to one variant — caller should use ISO codes for precision
- Missing or malformed 'country' parameter results in a validation error
- Network or upstream data-source outage returns a 5xx error

## How this service works

Country facts: capital, currencies, languages, population, timezones, calling code — Genesis402 / UnyKorn Operator Network

## Output

A structured object containing the country's capital city, list of currencies (with codes and symbols), official languages, estimated population, list of timezones (e.g. UTC+5:30), and international dialing/calling code — all keyed to the requested country.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "country": {
     "type": "string",
     "description": "required: ISO-2/3 code or name"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "country-info",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.001,
   "receipt_id": "g402-<16hex>"
  },
  "sources": [
   {
    "ok": true,
    "name": "<source>"
   }
  ],
  "limitations": "<text>",
  "generated_at": "<iso time>",
  "evidence_hash": "sha256:<64hex>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/country-facts-lookup-capital-currencies-languages-population-7d4475e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)