# Tokenguard Country Data Lookup

> Tokenguard Country Data Lookup is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns structured country information including name, capital, languages, currencies, population, and calling code for a given country code.

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/data/country
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-country-data-lookup-50067f7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h4qFct8bPsiSdpqcfa7rh

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 tokenguard-country-data-lookup-50067f7b -d '<json body>'
```

Example prompt: Can you look up the country details for Japan — I need its capital, official languages, currency, population, and international calling code?

## When to prefer this

Use this endpoint when you need structured, machine-readable country reference data (capital, language, currency, population, calling code) given an ISO 3166-1 alpha-2 code, especially within a crypto/DeFi agent workflow that already uses the Tokenguard API ecosystem and x402 micropayments on Base.

## Known failure modes

- Invalid or unrecognized country code returns an error or empty result
- Missing required cca2 field in request body causes a 400/422 error
- Network timeout or service unavailability on HuggingFace Space returns a 503
- Payment failure via x402 micropayment results in 402 Payment Required

## How this service works

Country reference data: capital, region, population, area, currencies, languages, calling code, timezones and borders

## Output

A JSON object containing the country's ISO alpha-2 code (cca2), full name, capital city array, official languages array, currencies array, total population, and international calling code (e.g. +81).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Country name (common or official)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cca2": "JP",
  "name": "Japan",
  "capital": [
   "Tokyo"
  ],
  "languages": [
   "Japanese"
  ],
  "currencies": [
   "JPY"
  ],
  "population": 125836021,
  "calling_code": "+81"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-country-data-lookup-50067f7b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)