{"uid":"cap_54ejyrKcU4MVqdOqI2JED","slug":"orbit-econ-data-country-facts-0e1ac09e","name":"Orbit Econ Data: Country Facts","description":"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.","url":"https://orbit-econ.orbit-builder.workers.dev/v1/country?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1Ey5kMRm8hriaetGSKkHr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Enrich user profile with country metadata","prompt":"I have a user who selected 'DE' as their country code — can you pull the full country details for Germany including its official name, capital, calling code, currency, and region?"},{"title":"Validate and display shipping destination info","prompt":"We're shipping to Japan — fetch me all the reference facts for Japan including its ISO codes, capital, TLD, languages, and whether it's landlocked."},{"title":"Research bordering countries for a geopolitical brief","prompt":"I'm preparing a brief on Central Asia — can you get me the country facts for Uzbekistan, including its bordering countries, region, subregion, and World Bank income level?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:30:12.148Z","isFirstParty":false,"canonicalSlug":"orbit-econ-data-country-facts-0e1ac09e"}