{"openapi":"3.1.0","info":{"title":"Current Account Balance API","version":"1.0.0","description":"Whether each economy earns more from the rest of the world than it spends — the current-account balance, live from the OECD's official balance-of-payments statistics, no key. The current account is the single most important external-balance number in macro: it nets a country's trade in goods and services, its cross-border investment income, and its transfers into one figure. A surplus means the economy is a net lender to the world and is accumulating foreign claims; a deficit means it is a net borrower, financing its spending with foreign capital. Persistent current-account positions are one of the deepest drivers of exchange rates — surplus currencies (the yen, the euro-area core, the Nordics) tend to be structurally supported, while large-deficit currencies depend on continued capital inflows and are vulnerable when risk appetite turns. The board endpoint ranks economies by their current-account balance as a share of GDP — the size-neutral cross-country screen — from biggest surpluses to biggest deficits. The goods endpoint ranks by the merchandise (goods) trade balance as a share of GDP, separating the trade story from services and income. The country endpoint gives one economy's full external decomposition: the headline balance as a share of GDP, the goods / services / primary-income / secondary-income balances in US dollars (which sum exactly to the current account) and as shares of GDP, the six-quarter trend, and a plain-language read of whether the position is improving or deteriorating and what drives it. Each reading carries its own quarter and discontinued series are filtered out. This is the external-balance / balance-of-payments cut — distinct from trade growth (real export and import growth rates, the flow of volumes, not the net balance), and from the inflation, labour-cost and confidence feeds. The headline is percent of GDP; the decomposition is in billions of US dollars per quarter and percent of GDP; figures are quarterly, seasonally adjusted.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/currentaccount-api","description":"oanor gateway"}],"tags":[{"name":"Country"},{"name":"Board"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Country"],"summary":"One economy's full external decomposition + trend","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-3 code or country name","schema":{"type":"string"},"example":"USA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"USA","name":"United States","note":"One economy's external balance: the headline current account as a share of GDP, decomposed into the goods, services, primary-income (cross-border investment income) and secondary-income (transfers) balances — in billions of US dollars per quarter (which sum exactly to the current account) and as shares of GDP. The six-quarter trend shows whether the position is widening or narrowing. Quarterly, seasonally adjusted, cached a few hours.","read":"Deficit of 2.43% of GDP, improving (balance up 1.76 pts year-on-year) — a net borrower from the world. Composition: goods -3.08%, services +1.04%, primary income +0.3%, secondary income -0.7% (of GDP). The balances sum to the current account.","trend":[{"period":"2024-Q3","balance_pct":-4.42},{"period":"2024-Q4","balance_pct":-4.18},{"period":"2025-Q1","balance_pct":-5.84},{"period":"2025-Q2","balance_pct":-3.25},{"period":"2025-Q3","balance_pct":-3.08},{"period":"2025-Q4","balance_pct":-2.43}],"period":"2025-Q4","source":"OECD balance-of-payments statistics (SDMX)","balance_pct":-2.43,"is_aggregate":false,"change_yoy_pts":1.76,"decomposition_usd_bn":{"goods":-241.46,"services":81.43,"primary_income":23.92,"current_account":-190.74,"secondary_income":-54.64},"decomposition_pct_gdp":{"goods":-3.08,"services":1.04,"primary_income":0.3,"secondary_income":-0.7}},"meta":{"timestamp":"2026-06-12T19:36:24.487Z","request_id":"df5a4c98-4a85-4134-9d89-0d4a2466a0d1"},"status":"ok","message":"Country external balance retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/board":{"get":{"operationId":"get_v1_board","tags":["Board"],"summary":"Economies ranked by current-account balance (% of GDP)","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"true to drop aggregates (euro area, OECD)","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Economies ranked by their current-account balance as a share of GDP — the size-neutral external-balance screen — from biggest surpluses to biggest deficits. A surplus means the economy is a net lender to the world; a deficit means it is a net borrower financing spending with foreign capital, the deepest structural driver of a currency. goods_pct and services_pct show the trade split. change_yoy_pts is versus four quarters ago. Each row carries its own quarter; discontinued series excluded. Pass countries_only=true to drop aggregates. Quarterly, seasonally adjusted, cached a few hours.","board":[{"code":"IRL","name":"Ireland","period":"2026-Q1","goods_pct":17.43,"balance_pct":12.9,"is_aggregate":false,"services_pct":6.9,"change_yoy_pts":8.61},{"code":"NOR","name":"Norway","period":"2025-Q4","goods_pct":11.68,"balance_pct":12.38,"is_aggregate":false,"services_pct":-2.17,"change_yoy_pts":-0.44},{"code":"DNK","name":"Denmark","period":"2026-Q1","goods_pct":10.61,"balance_pct":12.32,"is_aggregate":false,"services_pct":0.05,"change_yoy_pts":0.97},{"code":"NLD","name":"Netherlands","period":"2025-Q4","goods_pct":8.44,"balance_pct":10.89,"is_aggregate":false,"services_pct":3.87,"change_yoy_pts":-1.12},{"code":"KOR","name":"Korea","period":"2025-Q4","goods_pct":7.54,"balance_pct":7.64,"is_aggregate":false,"services_pct":-0.58,"change_yoy_pts":1.71},{"code":"JPN","name":"Japan","period":"2026-Q1","goods_pct":0.62,"balance_pct":5.77,"is_aggregate":false,"services_pct":-0.8,"change_yoy_pts":1.12},{"code":"SWE","name":"Sweden","period":"2025-Q4","goods_pct":4.01,"balance_pct":5.55,"is_aggregate":false,"services_pct":-1.63,"change_yoy_pts":-1.28},{"code":"CHN","name":"China (People’s Republic of)","period":"2025-Q4","goods_pct":5.21,"balance_pct":3.93,"is_aggregate":false,"services_pct":-1.08,"change_yoy_pts":1.08},{"code":"DEU","name":"Germany","period":"2025-Q4","goods_pct":3.53,"balance_pct":3.92,"is_aggregate":false,"services_pct":-1.69,"change_yoy_pts":-0.69},{"code":"LTU","name":"Lithuania","period":"2025-Q4","goods_pct":-6.59,"balance_pct":3.62,"is_aggregate":false,"services_pct":12.22,"change_yoy_pts":2.11},{"code":"ESP","name":"Spain","period":"2025-Q4","goods_pct":-2.62,"balance_pct":3.39,"is_aggregate":false,"services_pct":6.98,"change_yoy_pts":0.29},{"code":"CHE","name":"Switzerland","period":"2025-Q4","goods_pct":7.36,"balance_pct":3.02,"is_aggregate":false,"services_pct":-2.44,"change_yoy_pts":-5.9},{"code":"SVN","name":"Slovenia","period":"2025-Q4","goods_pct":-0.94,"balance_pct":2.75,"is_aggregate":false,"services_pct":5.74,"change_yoy_pts":-2.39},{"code":"HUN","name":"Hungary","period":"2025-Q4","goods_pct":-1.43,"balance_pct":2.59,"is_aggregate":false,"services_pct":5.49,"change_yoy_pts":-0.96},{"code":"ISR","name":"Israel","period":"2025-Q4","goods_pct":-3.03,"balance_pct":2.07,"is_aggregate":false,"services_pct":6.66,"change_yoy_pts":-0.67},{"code":"FIN","name":"Finland","period":"2025-Q4","goods_pct":3.43,"balance_pct":1.98,"is_aggregate":false,"services_pct":-1.85,"change_yoy_pts":2.4},{"code":"PRT","name":"Portugal","period":"2025-Q4","goods_pct":-8.86,"balance_pct":1.65,"is_aggregate":false,"services_pct":10.67,"change_yoy_pts":0.59},{"code":"AUT","name":"Austria","period":"2025-Q4","goods_pct":0.79,"balance_pct":1.4,"is_aggregate":false,"services_pct":1.5,"change_yoy_pts":0.77},{"code":"LUX","name":"Luxembourg","period":"2025-Q4","goods_pct":2.1,"balance_pct":1.23,"is_aggregate":false,"services_pct":30.69,"change_yoy_pts":1.35},{"code":"ITA","name":"Italy","period":"2025-Q4","goods_pct":2.57,"balance_pct":1.16,"is_aggregate":false,"services_pct":0.03,"change_yoy_pts":0.05},{"code":"CZE","name":"Czechia","period":"2025-Q4","goods_pct":5.02,"balance_pct":1.07,"is_aggregate":false,"services_pct":1.19,"change_yoy_pts":-1.67},{"code":"ZAF","name":"South Africa","period":"2025-Q4","goods_pct":3.89,"balance_pct":0.95,"is_aggregate":false,"services_pct":-0.96,"change_yoy_pts":1.62},{"code":"ARG","name":"Argentina","period":"2025-Q4","goods_pct":3.65,"balance_pct":0.83,"is_aggregate":false,"services_pct":-1.44,"change_yoy_pts":0.83},{"code":"FRA","name":"France","period":"2025-Q4","goods_pct":-1.17,"balance_pct":0.24,"is_aggregate":false,"services_pct":1.61,"change_yoy_pts":0.65},{"code":"POL","name":"Poland","period":"2025-Q4","goods_pct":-0.67,"balance_pct":0.16,"is_aggregate":false,"services_pct":4.14,"change_yoy_pts":0.55},{"code":"EST","name":"Estonia","period":"2026-Q1","balance_pct":0,"is_aggregate":false,"change_yoy_pts":0.4},{"code":"CRI","name":"Costa Rica","period":"2025-Q4","balance_pct":-0.17,"is_aggregate":false,"change_yoy_pts":0.78},{"code":"CHL","name":"Chile","period":"2026-Q1","goods_pct":7.67,"balance_pct":-0.31,"is_aggregate":false,"services_pct":-2.2,"change_yoy_pts":2.25},{"code":"MEX","name":"Mexico","period":"2025-Q4","goods_pct":-0.11,"balance_pct":-0.56,"is_aggregate":false,"services_pct":-0.93,"change_yoy_pts":-1.04},{"code":"IDN","name":"Indonesia","period":"2026-Q1","goods_pct":2.52,"balance_pct":-0.73,"is_aggregate":false,"services_pct":-1.27,"change_yoy_pts":-1.16},{"code":"CAN","name":"Canada","period":"2026-Q1","goods_pct":-0.93,"balance_pct":-0.87,"is_aggregate":false,"services_pct":0.16,"change_yoy_pts":-0.5},{"code":"IND","name":"India","period":"2025-Q4","goods_pct":-8.72,"balance_pct":-0.97,"is_aggregate":false,"services_pct":5.93,"change_yoy_pts":-0.24},{"code":"COL","name":"Colombia","period":"2026-Q1","goods_pct":-2.2,"balance_pct":-1.26,"is_aggregate":false,"services_pct":0.04,"change_yoy_pts":0.31},{"code":"SVK","name":"Slovak Republic","period":"2025-Q4","goods_pct":1.45,"balance_pct":-1.35,"is_aggregate":false,"services_pct":0.39,"change_yoy_pts":3.63},{"code":"LVA","name":"Latvia","period":"2026-Q1","goods_pct":-9.38,"balance_pct":-1.62,"is_aggregate":false,"services_pct":5.66,"change_yoy_pts":1.28},{"code":"BRA","name":"Brazil","period":"2025-Q4","goods_pct":1.38,"balance_pct":-1.81,"is_aggregate":false,"services_pct":-1.27,"change_yoy_pts":2.64},{"code":"GBR","name":"United Kingdom","period":"2025-Q4","goods_pct":-8.51,"balance_pct":-2.39,"is_aggregate":false,"services_pct":6.93,"change_yoy_pts":1.35},{"code":"USA","name":"United States","period":"2025-Q4","goods_pct":-3.08,"balance_pct":-2.43,"is_aggregate":false,"services_pct":1.04,"change_yoy_pts":1.76},{"code":"TUR","name":"Türkiye","period":"2025-Q4","goods_pct":-5.1,"balance_pct":-2.54,"is_aggregate":false,"services_pct":3.54,"change_yoy_pts":-0.85},{"code":"SAU","name":"Saudi Arabia","period":"2025-Q4","goods_pct":7.81,"balance_pct":-2.55,"is_aggregate":false,"services_pct":-4.88,"change_yoy_pts":1.46},{"code":"BEL","name":"Belgium","period":"2025-Q4","goods_pct":-0.91,"balance_pct":-2.95,"is_aggregate":false,"services_pct":-2.3,"change_yoy_pts":-2.44},{"code":"ISL","name":"Iceland","period":"2025-Q4","balance_pct":-3.13,"is_aggregate":false,"change_yoy_pts":4.33},{"code":"AUS","name":"Australia","period":"2026-Q1","goods_pct":0.9,"balance_pct":-3.68,"is_aggregate":false,"services_pct":-1.23,"change_yoy_pts":-1.25},{"code":"NZL","name":"New Zealand","period":"2025-Q4","goods_pct":-0.76,"balance_pct":-4.1,"is_aggregate":false,"services_pct":0.11,"change_yoy_pts":-0.6},{"code":"GRC","name":"Greece","period":"2025-Q4","goods_pct":-13.94,"balance_pct":-6.25,"is_aggregate":false,"services_pct":9.34,"change_yoy_pts":1.4}],"count":45,"source":"OECD balance-of-payments statistics (SDMX), current account, % of GDP, seasonally adjusted","indicator":"Current account balance (% of GDP)","latest_period":"2026-Q1"},"meta":{"timestamp":"2026-06-12T19:36:24.594Z","request_id":"a7a4065e-c6b2-4e88-8540-f98d7bdd7f3d"},"status":"ok","message":"Current account board retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/goods":{"get":{"operationId":"get_v1_goods","tags":["Board"],"summary":"Economies ranked by goods (merchandise trade) balance (% of GDP)","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"true to drop aggregates","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Economies ranked by their merchandise (goods) trade balance as a share of GDP — the pure trade-in-goods story, separated from services and investment income. A goods surplus (Germany, Korea, the oil exporters) versus a goods deficit (the US, the UK) is the visible half of the external balance; the gap between goods_pct and the current_account_pct is what services and income add back. Shares of GDP are derived from the headline's implied GDP (exact). Quarterly, seasonally adjusted, cached a few hours.","board":[{"code":"IRL","name":"Ireland","period":"2026-Q1","goods_pct":17.43,"goods_usd_bn":28.84,"is_aggregate":false,"services_pct":6.9,"current_account_pct":12.9},{"code":"NOR","name":"Norway","period":"2025-Q4","goods_pct":11.68,"goods_usd_bn":15.62,"is_aggregate":false,"services_pct":-2.17,"current_account_pct":12.38},{"code":"DNK","name":"Denmark","period":"2026-Q1","goods_pct":10.61,"goods_usd_bn":12.87,"is_aggregate":false,"services_pct":0.05,"current_account_pct":12.32},{"code":"NLD","name":"Netherlands","period":"2025-Q4","goods_pct":8.44,"goods_usd_bn":29.5,"is_aggregate":false,"services_pct":3.87,"current_account_pct":10.89},{"code":"SAU","name":"Saudi Arabia","period":"2025-Q4","goods_pct":7.81,"goods_usd_bn":21.62,"is_aggregate":false,"services_pct":-4.88,"current_account_pct":-2.55},{"code":"CHL","name":"Chile","period":"2026-Q1","goods_pct":7.67,"goods_usd_bn":7.69,"is_aggregate":false,"services_pct":-2.2,"current_account_pct":-0.31},{"code":"KOR","name":"Korea","period":"2025-Q4","goods_pct":7.54,"goods_usd_bn":83.86,"is_aggregate":false,"services_pct":-0.58,"current_account_pct":7.64},{"code":"CHE","name":"Switzerland","period":"2025-Q4","goods_pct":7.36,"goods_usd_bn":19.9,"is_aggregate":false,"services_pct":-2.44,"current_account_pct":3.02},{"code":"CHN","name":"China (People’s Republic of)","period":"2025-Q4","goods_pct":5.21,"goods_usd_bn":284.92,"is_aggregate":false,"services_pct":-1.08,"current_account_pct":3.93},{"code":"CZE","name":"Czechia","period":"2025-Q4","goods_pct":5.02,"goods_usd_bn":5.3,"is_aggregate":false,"services_pct":1.19,"current_account_pct":1.07},{"code":"SWE","name":"Sweden","period":"2025-Q4","goods_pct":4.01,"goods_usd_bn":7.12,"is_aggregate":false,"services_pct":-1.63,"current_account_pct":5.55},{"code":"ZAF","name":"South Africa","period":"2025-Q4","goods_pct":3.89,"goods_usd_bn":4.45,"is_aggregate":false,"services_pct":-0.96,"current_account_pct":0.95},{"code":"ARG","name":"Argentina","period":"2025-Q4","goods_pct":3.65,"goods_usd_bn":5.96,"is_aggregate":false,"services_pct":-1.44,"current_account_pct":0.83},{"code":"DEU","name":"Germany","period":"2025-Q4","goods_pct":3.53,"goods_usd_bn":46.58,"is_aggregate":false,"services_pct":-1.69,"current_account_pct":3.92},{"code":"FIN","name":"Finland","period":"2025-Q4","goods_pct":3.43,"goods_usd_bn":2.82,"is_aggregate":false,"services_pct":-1.85,"current_account_pct":1.98},{"code":"ITA","name":"Italy","period":"2025-Q4","goods_pct":2.57,"goods_usd_bn":17.09,"is_aggregate":false,"services_pct":0.03,"current_account_pct":1.16},{"code":"IDN","name":"Indonesia","period":"2026-Q1","goods_pct":2.52,"goods_usd_bn":9.43,"is_aggregate":false,"services_pct":-1.27,"current_account_pct":-0.73},{"code":"LUX","name":"Luxembourg","period":"2025-Q4","goods_pct":2.1,"goods_usd_bn":0.57,"is_aggregate":false,"services_pct":30.69,"current_account_pct":1.23},{"code":"SVK","name":"Slovak Republic","period":"2025-Q4","goods_pct":1.45,"goods_usd_bn":0.59,"is_aggregate":false,"services_pct":0.39,"current_account_pct":-1.35},{"code":"BRA","name":"Brazil","period":"2025-Q4","goods_pct":1.38,"goods_usd_bn":14.7,"is_aggregate":false,"services_pct":-1.27,"current_account_pct":-1.81},{"code":"AUS","name":"Australia","period":"2026-Q1","goods_pct":0.9,"goods_usd_bn":4.58,"is_aggregate":false,"services_pct":-1.23,"current_account_pct":-3.68},{"code":"AUT","name":"Austria","period":"2025-Q4","goods_pct":0.79,"goods_usd_bn":1.19,"is_aggregate":false,"services_pct":1.5,"current_account_pct":1.4},{"code":"JPN","name":"Japan","period":"2026-Q1","goods_pct":0.62,"goods_usd_bn":6.65,"is_aggregate":false,"services_pct":-0.8,"current_account_pct":5.77},{"code":"MEX","name":"Mexico","period":"2025-Q4","goods_pct":-0.11,"goods_usd_bn":-0.52,"is_aggregate":false,"services_pct":-0.93,"current_account_pct":-0.56},{"code":"POL","name":"Poland","period":"2025-Q4","goods_pct":-0.67,"goods_usd_bn":-1.89,"is_aggregate":false,"services_pct":4.14,"current_account_pct":0.16},{"code":"NZL","name":"New Zealand","period":"2025-Q4","goods_pct":-0.76,"goods_usd_bn":-0.5,"is_aggregate":false,"services_pct":0.11,"current_account_pct":-4.1},{"code":"BEL","name":"Belgium","period":"2025-Q4","goods_pct":-0.91,"goods_usd_bn":-1.72,"is_aggregate":false,"services_pct":-2.3,"current_account_pct":-2.95},{"code":"CAN","name":"Canada","period":"2026-Q1","goods_pct":-0.93,"goods_usd_bn":-5.63,"is_aggregate":false,"services_pct":0.16,"current_account_pct":-0.87},{"code":"SVN","name":"Slovenia","period":"2025-Q4","goods_pct":-0.94,"goods_usd_bn":-0.2,"is_aggregate":false,"services_pct":5.74,"current_account_pct":2.75},{"code":"FRA","name":"France","period":"2025-Q4","goods_pct":-1.17,"goods_usd_bn":-10.38,"is_aggregate":false,"services_pct":1.61,"current_account_pct":0.24},{"code":"HUN","name":"Hungary","period":"2025-Q4","goods_pct":-1.43,"goods_usd_bn":-0.96,"is_aggregate":false,"services_pct":5.49,"current_account_pct":2.59},{"code":"COL","name":"Colombia","period":"2026-Q1","goods_pct":-2.2,"goods_usd_bn":-2.87,"is_aggregate":false,"services_pct":0.04,"current_account_pct":-1.26},{"code":"ESP","name":"Spain","period":"2025-Q4","goods_pct":-2.62,"goods_usd_bn":-13.24,"is_aggregate":false,"services_pct":6.98,"current_account_pct":3.39},{"code":"ISR","name":"Israel","period":"2025-Q4","goods_pct":-3.03,"goods_usd_bn":-5.03,"is_aggregate":false,"services_pct":6.66,"current_account_pct":2.07},{"code":"USA","name":"United States","period":"2025-Q4","goods_pct":-3.08,"goods_usd_bn":-241.46,"is_aggregate":false,"services_pct":1.04,"current_account_pct":-2.43},{"code":"TUR","name":"Türkiye","period":"2025-Q4","goods_pct":-5.1,"goods_usd_bn":-21.54,"is_aggregate":false,"services_pct":3.54,"current_account_pct":-2.54},{"code":"LTU","name":"Lithuania","period":"2025-Q4","goods_pct":-6.59,"goods_usd_bn":-1.66,"is_aggregate":false,"services_pct":12.22,"current_account_pct":3.62},{"code":"GBR","name":"United Kingdom","period":"2025-Q4","goods_pct":-8.51,"goods_usd_bn":-87.08,"is_aggregate":false,"services_pct":6.93,"current_account_pct":-2.39},{"code":"IND","name":"India","period":"2025-Q4","goods_pct":-8.72,"goods_usd_bn":-85.88,"is_aggregate":false,"services_pct":5.93,"current_account_pct":-0.97},{"code":"PRT","name":"Portugal","period":"2025-Q4","goods_pct":-8.86,"goods_usd_bn":-8.1,"is_aggregate":false,"services_pct":10.67,"current_account_pct":1.65},{"code":"LVA","name":"Latvia","period":"2026-Q1","goods_pct":-9.38,"goods_usd_bn":-1.22,"is_aggregate":false,"services_pct":5.66,"current_account_pct":-1.62},{"code":"GRC","name":"Greece","period":"2025-Q4","goods_pct":-13.94,"goods_usd_bn":-10.36,"is_aggregate":false,"services_pct":9.34,"current_account_pct":-6.25}],"count":42,"source":"OECD balance-of-payments statistics (SDMX), goods balance, seasonally adjusted","indicator":"Goods (merchandise trade) balance (% of GDP)","latest_period":"2026-Q1"},"meta":{"timestamp":"2026-06-12T19:36:24.701Z","request_id":"cba921fd-4593-42b6-a983-03beb4d8f7ef"},"status":"ok","message":"Goods balance board retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"board and goods take countries_only (true to drop aggregates such as the euro area). country takes country (ISO-3 code or name, required). meta takes no parameters. The headline balance is percent of GDP; the decomposition is in billions of US dollars per quarter (summing exactly to the current account) and percent of GDP (derived from the headline's implied GDP). change_yoy_pts is versus four quarters ago. Each row carries its own quarter; discontinued series are filtered out. Quarterly data; a multi-hour protective cache fronts the OECD upstream.","source":"OECD balance-of-payments (DF_BOP, current account vs rest-of-world, balances) via OECD SDMX API, % of GDP and US dollars, quarterly, seasonally adjusted, live, keyless","service":"currentaccount-api","economies":49,"endpoints":{"GET /v1/meta":"This document.","GET /v1/board":"Economies ranked by current-account balance as a share of GDP (countries_only optional).","GET /v1/goods":"Economies ranked by the goods (merchandise trade) balance as a share of GDP.","GET /v1/country":"One economy's full external decomposition + six-quarter trend (country=USA)."},"description":"Current account balance by country — whether each economy is a net lender or borrower to the world, live from the OECD's balance-of-payments statistics (no key). It serves the headline current-account balance as a share of GDP (the size-neutral FX-fundamental screen), the goods (merchandise trade) balance as a share of GDP, and a full per-country decomposition into goods, services, primary income and secondary income — in US dollars and as shares of GDP, with a six-quarter trend. The external-balance cut — distinct from trade growth (real export/import growth rates, the flow of volumes, not the net balance), and from the inflation, labour-cost and confidence feeds.","united_states":{"period":"2025-Q4","goods_pct":-3.08,"balance_pct":-2.43,"services_pct":1.04},"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T19:36:24.772Z","request_id":"0a3a1882-bd5d-48c9-9660-875a91162f11"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1450,"monthly_call_quota":16200,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4300,"monthly_call_quota":84000,"rps_limit":16,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":9600,"monthly_call_quota":490000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/currentaccount-api"}