# Country Facts

Borders, driving side, time zones, land routes and comparisons for 250 countries and territories.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://country-facts.x402tookit.com/openapi.json
- x402 manifest: https://country-facts.x402tookit.com/.well-known/x402
- Catalog (free): https://country-facts.x402tookit.com/catalog
- Health (free): https://country-facts.x402tookit.com/health
- Uptime (free): https://country-facts.x402tookit.com/uptime

## Endpoints (8)

### GET /border-path — $0.02
Fewest land border crossings between two countries, with the countries passed through, or NO_LAND_ROUTE.
Params: from: string, to: string
Example: https://country-facts.x402tookit.com/border-path?from=Portugal&to=Germany

### GET /borders — $0.02
List a country's land neighbours, or all countries within 2-3 border crossings, with landlocked status.
Params: country: string, depth?: integer
Example: https://country-facts.x402tookit.com/borders?country=Germany

### GET /countries-filter — $0.02
List countries by region, currency code, language, driving side, landlocked or UN membership; at least one filter.
Params: region?: string, subregion?: string, currency?: string, language?: string, driving?: string, landlocked?: boolean, unMember?: boolean, limit?: integer
Example: https://country-facts.x402tookit.com/countries-filter?driving=left&region=Africa

### GET /country-compare — $0.02
Compare two countries: size ratio, border crossings between them, shared currency and language, driving side, distance.
Params: a: string, b: string
Example: https://country-facts.x402tookit.com/country-compare?a=Germany&b=France

### GET /country-profile — $0.02
Country fact sheet by code or name: region, capital, area, borders, currencies, languages, calling code, driving side, zones.
Params: country: string
Example: https://country-facts.x402tookit.com/country-profile?country=Germany

### GET /driving-side — $0.02
Which side of the road a country drives on, and which neighbours drive on the other side (switch borders).
Params: country: string
Example: https://country-facts.x402tookit.com/driving-side?country=Thailand

### GET /time-difference — $0.02
Clock difference in hours between two countries or IANA zones at a given moment, flagging countries with several offsets.
Params: a: string, b: string, at?: string
Example: https://country-facts.x402tookit.com/time-difference?a=India&b=Japan&at=2026-01-15

### GET /timezones — $0.02
IANA time zones for a country with UTC offsets and daylight-saving flags at a given moment (default now).
Params: country: string, at?: string
Example: https://country-facts.x402tookit.com/timezones?country=India&at=2026-01-15

## Terms

Country facts come from embedded tables built from the mledoze countries dataset, the IANA time zone database and Wikidata, provided as is. Borders and names reflect the sources at build time, disputed territories are shown as the sources list them without taking a position, and traffic rules, time zones and area figures change. Not legal, travel, border-crossing or navigation advice.