{"openapi":"3.1.0","info":{"title":"Money Supply API","version":"1.0.0","description":"How fast the money in each economy is growing — narrow money (M1) and broad money (M3) growth as an API, live from the OECD's official monetary statistics, no key. The money supply is the total stock of money in circulation: M1 is cash and instantly-spendable deposits (the transactional money that turns over fast), M3 is M1 plus savings and near-money. How fast it grows is one of the oldest macro signals there is — money growth running well ahead of the economy is the classic fuel for inflation and asset-price booms, while money contracting flags a credit squeeze. Central banks, bond traders and macro investors watch the year-on-year money-growth rate to read the liquidity tide. The OECD publishes a seasonally-adjusted monetary-aggregate index for each economy; this API turns it into the number people actually use — the year-on-year and month-on-month growth of M1 and M3. The board endpoint ranks every economy by its broad-money (M3) growth, with narrow money (M1) alongside, so you can see where liquidity is expanding fastest and where it is drying up. The narrow endpoint ranks by M1 growth — narrow money turns over fastest and tends to lead. The country endpoint gives one economy's M1 and M3 growth, year-on-year and month-on-month. Each reading carries its own period and discontinued series are excluded, so the board is genuinely current. The money-supply / monetary-growth cut — distinct from the central-bank policy-rate APIs (the price of money, not its quantity), the inflation board, and the generic multi-provider data aggregator. Figures are monthly, in percent.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/moneysupply-api","description":"oanor gateway"}],"tags":[{"name":"Board"},{"name":"Narrow"},{"name":"Country"},{"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/board":{"get":{"operationId":"get_v1_board","tags":["Board"],"summary":"Economies ranked by broad-money (M3) growth, with M1","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"Drop aggregate groups (true)","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Economies ranked by year-on-year broad-money (M3) growth, with narrow money (M1) alongside. Money growth well ahead of the economy is the classic fuel for inflation and asset booms; contracting money flags a credit squeeze. Growth computed from the OECD's seasonally-adjusted monetary-aggregate index. Each row carries its own period; discontinued series are excluded. Monthly, cached a few hours.","board":[{"code":"COL","name":"Colombia","m1_mom":0.78,"m1_yoy":11.33,"m3_mom":0.99,"m3_yoy":11.51,"period":"2026-04","signal":"rapid money growth — strongly expansionary liquidity","is_aggregate":false},{"code":"ZAF","name":"South Africa","m3_mom":1.13,"m3_yoy":9.41,"period":"2026-04","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"HUN","name":"Hungary","m1_mom":0.96,"m1_yoy":7.88,"m3_mom":1.18,"m3_yoy":8.24,"period":"2026-03","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"AUS","name":"Australia","m1_mom":0.33,"m1_yoy":10.12,"m3_mom":0.75,"m3_yoy":8.2,"period":"2026-04","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"NOR","name":"Norway","m3_mom":0.51,"m3_yoy":7.58,"period":"2026-04","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"CZE","name":"Czechia","m3_mom":0.54,"m3_yoy":5.37,"period":"2026-04","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"ISR","name":"Israel","m1_mom":0.33,"m1_yoy":6.53,"m3_mom":1.06,"m3_yoy":5.33,"period":"2025-12","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"KOR","name":"Korea","m1_mom":0.96,"m1_yoy":7.48,"m3_mom":0.36,"m3_yoy":5.03,"period":"2026-03","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"CRI","name":"Costa Rica","m1_mom":-0.35,"m1_yoy":4.59,"m3_mom":-0.03,"m3_yoy":4.87,"period":"2026-01","signal":"moderate money growth","is_aggregate":false},{"code":"USA","name":"United States","m1_mom":0.49,"m1_yoy":4.89,"m3_mom":0.52,"m3_yoy":4.72,"period":"2026-04","signal":"moderate money growth","is_aggregate":false},{"code":"GBR","name":"United Kingdom","m1_mom":0.27,"m1_yoy":2.57,"m3_mom":0.39,"m3_yoy":4.15,"period":"2026-04","signal":"moderate money growth","is_aggregate":false},{"code":"CAN","name":"Canada","m1_mom":0.59,"m1_yoy":6.8,"m3_mom":0.39,"m3_yoy":3.62,"period":"2026-03","signal":"moderate money growth","is_aggregate":false},{"code":"JPN","name":"Japan","m1_mom":-0.07,"m1_yoy":-0.44,"m3_mom":0.22,"m3_yoy":1.41,"period":"2026-03","signal":"slow money growth — tight liquidity","is_aggregate":false}],"count":13,"source":"OECD monetary aggregates (SDMX), seasonally adjusted","aggregate":"M3 (broad money)","latest_period":"2026-04"},"meta":{"timestamp":"2026-06-12T19:37:37.082Z","request_id":"b40da234-564b-47f0-bb00-e83466e2533f"},"status":"ok","message":"Money supply 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/narrow":{"get":{"operationId":"get_v1_narrow","tags":["Narrow"],"summary":"Economies ranked by narrow-money (M1) growth","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"Drop aggregate groups (true)","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Economies ranked by year-on-year narrow-money (M1) growth — cash and instantly-spendable deposits, which turn over fastest and tend to lead. Broad money (M3) alongside. Growth computed from the OECD's seasonally-adjusted monetary-aggregate index. Monthly, cached a few hours.","board":[{"code":"COL","name":"Colombia","m1_mom":0.78,"m1_yoy":11.33,"m3_mom":0.99,"m3_yoy":11.51,"period":"2026-04","signal":"rapid money growth — strongly expansionary liquidity","is_aggregate":false},{"code":"AUS","name":"Australia","m1_mom":0.33,"m1_yoy":10.12,"m3_mom":0.75,"m3_yoy":8.2,"period":"2026-04","signal":"rapid money growth — strongly expansionary liquidity","is_aggregate":false},{"code":"HUN","name":"Hungary","m1_mom":0.96,"m1_yoy":7.88,"m3_mom":1.18,"m3_yoy":8.24,"period":"2026-03","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"KOR","name":"Korea","m1_mom":0.96,"m1_yoy":7.48,"m3_mom":0.36,"m3_yoy":5.03,"period":"2026-03","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"CAN","name":"Canada","m1_mom":0.59,"m1_yoy":6.8,"m3_mom":0.39,"m3_yoy":3.62,"period":"2026-03","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"ISR","name":"Israel","m1_mom":0.33,"m1_yoy":6.53,"m3_mom":1.06,"m3_yoy":5.33,"period":"2025-12","signal":"above-average money growth — expansionary","is_aggregate":false},{"code":"USA","name":"United States","m1_mom":0.49,"m1_yoy":4.89,"m3_mom":0.52,"m3_yoy":4.72,"period":"2026-04","signal":"moderate money growth","is_aggregate":false},{"code":"CRI","name":"Costa Rica","m1_mom":-0.35,"m1_yoy":4.59,"m3_mom":-0.03,"m3_yoy":4.87,"period":"2026-01","signal":"moderate money growth","is_aggregate":false},{"code":"GBR","name":"United Kingdom","m1_mom":0.27,"m1_yoy":2.57,"m3_mom":0.39,"m3_yoy":4.15,"period":"2026-04","signal":"moderate money growth","is_aggregate":false},{"code":"BRA","name":"Brazil","m1_mom":-0.15,"m1_yoy":0.21,"period":"2026-04","signal":"slow money growth — tight liquidity","is_aggregate":false},{"code":"JPN","name":"Japan","m1_mom":-0.07,"m1_yoy":-0.44,"m3_mom":0.22,"m3_yoy":1.41,"period":"2026-03","signal":"money contracting — credit squeeze","is_aggregate":false}],"count":11,"source":"OECD monetary aggregates (SDMX), seasonally adjusted","aggregate":"M1 (narrow money)","latest_period":"2026-04"},"meta":{"timestamp":"2026-06-12T19:37:37.187Z","request_id":"4036472c-2545-4578-9d20-f8debe305b9d"},"status":"ok","message":"Narrow money 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/country":{"get":{"operationId":"get_v1_country","tags":["Country"],"summary":"One economy's M1 and M3 growth, year-on-year and month-on-month","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-3 code or name","schema":{"type":"string"},"example":"USA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"m1":{"mom":0.49,"yoy":4.89,"period":"2026-04","signal":"moderate money growth"},"m3":{"mom":0.52,"yoy":4.72,"period":"2026-04","signal":"moderate money growth"},"code":"USA","name":"United States","note":"One economy's narrow (M1) and broad (M3) money growth, year-on-year and month-on-month, from the OECD's seasonally-adjusted monetary-aggregate index. Fast money growth is expansionary/inflationary liquidity; contraction flags a credit squeeze. Monthly, cached a few hours.","period":"2026-04","source":"OECD monetary aggregates (SDMX)","is_aggregate":false},"meta":{"timestamp":"2026-06-12T19:37:37.268Z","request_id":"e7f4e0ff-726f-41a3-9ddd-e76156de4277"},"status":"ok","message":"Country money supply 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 narrow take countries_only (true to drop aggregates). country takes country (ISO-3 code or name, required). meta takes no parameters. Growth figures are in percent; yoy is year-on-year, mom is month-on-month, computed from the monetary-aggregate index. Monthly data; a multi-hour protective cache fronts the OECD upstream.","source":"OECD monetary aggregates (DF_MONAGG) via OECD SDMX API (M1=MANM, M3=MABM, seasonally adjusted), live, keyless","service":"moneysupply-api","economies":17,"endpoints":{"GET /v1/meta":"This document.","GET /v1/board":"Economies ranked by broad-money (M3) growth, with M1 alongside (countries_only optional).","GET /v1/narrow":"Economies ranked by narrow-money (M1) growth.","GET /v1/country":"One economy's M1 and M3 growth, year-on-year and month-on-month (country=USA)."},"description":"Money supply — how fast the money in each economy is growing, live from the OECD's monetary statistics (no key). It computes the year-on-year and month-on-month growth of narrow money (M1) and broad money (M3) from the OECD's seasonally-adjusted index. board ranks every economy by M3 (broad money) growth with M1 alongside; narrow ranks by M1 growth; country gives one economy's M1 and M3 growth. Money growth running ahead of the economy is the classic fuel for inflation and asset booms; contraction flags a credit squeeze. The money-supply / monetary-growth cut — distinct from central-bank policy-rate APIs (the price of money, not its quantity), the inflation board, and the generic data aggregator.","united_states":{"m1_yoy":4.89,"m3_yoy":4.72},"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T19:37:37.357Z","request_id":"a4eaf2cb-ac40-4521-b548-0bea6e92c4b5"},"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":815,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1160,"monthly_call_quota":18100,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3520,"monthly_call_quota":91500,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7960,"monthly_call_quota":506000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/moneysupply-api"}