# Orbit Econ Data: Country Facts

> Orbit Econ Data: Country Facts is a paid API for AI agents from orbit-econ.orbit-builder.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-29).

Returns comprehensive reference facts for any of 250 countries or territories by ISO code or English name, including names, capital, region, languages, currencies, calling codes, TLD, coordinates, area, borders, and World Bank classification.

## Facts

- Endpoint: GET https://orbit-econ.orbit-builder.workers.dev/v1/country?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orbit-econ-data-country-facts-0e1ac09e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_54ejyrKcU4MVqdOqI2JED

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 orbit-econ-data-country-facts-0e1ac09e
```

Example prompt: Can you look up the country facts for Kazakhstan — I need its capital, official name, ISO codes, currencies, calling codes, and World Bank income level.

## When to prefer this

Choose this endpoint when you need structured reference data about a specific country — especially when you need multiple fields at once (ISO codes, capital, currencies, calling codes, borders, World Bank classification) in a single call. Prefer this over a general web search when you need machine-readable, structured country metadata that is consistent across all 250 countries/territories. This is ideal for enriching user profiles, validating country inputs, or building country-picker UIs.

## Known failure modes

- Unknown or misspelled country name/code returns an error or empty result
- Ambiguous name input (e.g. 'Georgia' — country vs US state) may resolve to unexpected result
- No query param provided runs the example (Kazakhstan) instead of failing
- Very small territories or disputed regions may not be in the dataset
- Network or worker timeout for slow connections

## How this service works

Economic and country data for agents: European Central Bank FX reference rates, currency conversion and rate history (via Frankfurter), country reference facts for 250 countries, and the latest World Bank macro indicators (GDP, growth, inflation, population, unemployment…). Open data with attribution, fetched at call time. $0.001 per call. By orbit-builder.

## Output

A JSON object containing the country's common name, official name, ISO alpha-2/alpha-3/numeric codes, capital city array, region, subregion, list of languages, currencies (with code, name, and symbol), calling codes, internet TLDs, latitude/longitude, area in km², list of bordering country ISO codes, landlocked boolean, UN member boolean, flag emoji, and World Bank region and income level classification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "country": {
       "type": "string",
       "description": "ISO alpha-2/alpha-3 code or English name, e.g. KZ, DEU, Japan"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tld": [
   ".kz",
   ".қаз"
  ],
  "cca2": "KZ",
  "cca3": "KAZ",
  "flag": "🇰🇿",
  "name": "Kazakhstan",
  "region": "Asia",
  "borders": [
   "CHN",
   "KGZ",
   "RUS",
   "TKM",
   "UZB"
  ],
  "capital": [
   "Astana"
  ],
  "area_km2": 2724900,
  "languages": [
   "Kazakh",
   "Russian"
  ],
  "subregion": "Central Asia",
  "worldbank": {
   "region": "Europe & Central Asia",
   "income_level": "Upper middle income"
  },
  "currencies": [
   {
    "code": "KZT",
    "name": "Kazakhstani tenge",
    "symbol": "₸"
   }
  ],
  "calling_codes": [
   "+76",
   "+77"
  ],
  "official_name": "Republic of Kazakhstan"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orbit-econ-data-country-facts-0e1ac09e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from orbit-econ.orbit-builder.workers.dev](https://www.zero.xyz/host/orbit-econ.orbit-builder.workers.dev/llms.txt)