# NBP > Official exchange rates and gold prices from Narodowy Bank Polski, the central bank of Poland - the figures Polish invoices, VAT returns, customs declarations and audited accounts are settled at. Convert an amount between any two of the roughly 170 currencies NBP quotes, look up a rate for today or for the day an invoice was raised, and take it on the basis Polish tax law asks for: the rate published on the last working day before. Pull a whole table in one step, chart a rate over time, read the buy and sell prices NBP quotes in table C, and follow the official price of gold per gram, ounce or kilogram. Rates go back to 2002 and gold prices to 2013. No account or API key required. App · Accounting & Finance · 9 actions. Web page: https://docs.lodol.com/docs/integrations/nbp ## Actions ### Compare a rate between two dates See how far a rate has moved between two dates, as a percentage and as a number. The step to put in front of a condition: alert when the złoty has moved more than two per cent since a contract was signed, or since the start of the quarter. No API key required. **Inputs** - From (`from_currency`, text): The currency being converted from. Defaults to the euro. Default: `EUR`. - To (`to_currency`, text): The currency being converted into. Defaults to the Polish złoty. Default: `PLN`. - Start date (`start_date`, date, required): The earlier date to measure the move from. A weekend or a Polish holiday uses the last rate published before it. - End date (`end_date`, date): Optional. The later date to measure the move to. Defaults to the latest published rate. **Outputs** - `change` (number): How much the rate moved in absolute terms. - `change_percent` (number): How much the rate moved, as a percentage of where it started. Negative when it fell. This is the number to compare against a threshold. - `direction` (text): Which way the rate moved: up, down or unchanged. - `from_currency` (text): The source currency's three-letter code, such as EUR. - `from_currency_name` (text): NBP's own name for the source currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. - `from_rate` (number): The rate on the earlier date. - `from_rate_date` (text): The day the earlier rate was published for. - `summary` (text): The move as a sentence, ready to show someone. - `to_currency` (text): The target currency's three-letter code, such as EUR. - `to_currency_name` (text): NBP's own name for the target currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. - `to_rate` (number): The rate on the later date. - `to_rate_date` (text): The day the later rate was published for. **Example output** ```json { "change": -0.0578, "change_percent": -1.35, "direction": "down", "from_currency": "EUR", "from_currency_name": "euro", "from_rate": 4.2862, "from_rate_date": "2026-01-02", "summary": "1 EUR bought 4.2284 PLN on 2026-09-11, down 1.35% from 4.2862 on 2026-01-02", "to_currency": "PLN", "to_currency_name": "z\u0142oty polski", "to_rate": 4.2284, "to_rate_date": "2026-09-11" } ``` ### Convert an amount Convert an amount of money at the National Bank of Poland's official average exchange rate - the rate Polish invoices, customs declarations, VAT returns and audited accounts are settled at. Use the latest rate, the rate in force on a date you name, or the rate published on the last working day before it, which is what Polish tax law asks for. Works between any two of the roughly 170 currencies NBP quotes, not just to and from the złoty. No API key required. **Inputs** - Amount (`amount`, number, required): How much to convert, in the 'From' currency. - From (`from_currency`, text): The currency being converted from. Defaults to the euro. Default: `EUR`. - To (`to_currency`, text): The currency being converted into. Defaults to the Polish złoty. Default: `PLN`. - Date (`on_date`, date): Optional. The day to use the rate from. NBP publishes on working days only, so a weekend or a Polish public holiday uses the last rate published before it - the one still in force. Leave empty for the latest rate. - Which rate (`rate_basis`, text): Which publication to take the rate from. 'The rate in force on that day' is the plain reading of a date. 'The last rate published before that day' is what Polish tax law asks for when converting an invoice or a tax obligation - a different figure on every day NBP publishes. One of: `in_force` (The rate in force on that day), `previous_day` (The last rate published before that day). Default: `in_force`. **Outputs** - `amount` (number): The amount that was converted. - `converted_amount` (number): The amount in the 'To' currency, to two decimal places. - `from_currency` (text): The source currency's three-letter code, such as EUR. - `from_currency_name` (text): NBP's own name for the source currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. - `rate` (number): The rate used: how many of the 'To' currency one of the 'From' currency bought. - `rate_basis` (text): Which basis was used: in_force or previous_day. - `rate_basis_label` (text): The same thing in words, ready to put on a document. - `rate_date` (text): The day NBP published this rate for, as YYYY-MM-DD. Worth reading whenever a date was asked for: a weekend, a holiday or the invoicing basis all answer with an earlier day. - `requested_date` (text): The date that was asked for, or empty when the latest rate was asked for. Compare it with the rate's own date to see whether NBP published that day. - `summary` (text): The conversion as a sentence, ready to show someone: '250 EUR = 1057.1 PLN'. - `table` (text): Which of NBP's tables the rate came from: A for a convertible currency, B for a less common one. A crossed rate names both. - `table_number` (text): NBP's own number for the publication, such as 177/A/NBP/2026 - the reference a Polish invoice or tax filing cites. A crossed rate names both publications. - `to_currency` (text): The target currency's three-letter code, such as EUR. - `to_currency_name` (text): NBP's own name for the target currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. **Example output** ```json { "amount": 250, "converted_amount": 1057.1, "from_currency": "EUR", "from_currency_name": "euro", "rate": 4.2284, "rate_basis": "in_force", "rate_basis_label": "The rate in force on that day", "rate_date": "2026-09-11", "requested_date": "", "summary": "250 EUR = 1057.1 PLN", "table": "A", "table_number": "177/A/NBP/2026", "to_currency": "PLN", "to_currency_name": "z\u0142oty polski" } ``` ### Get a rate over time Get a rate between two currencies across a stretch of time - for a chart, a trend, or a loop over each publication. Comes back with the high, the low, the average and how far the rate moved over the range, as well as the rates themselves. NBP answers at most 93 days per request; this step splits a longer range across as many requests as it takes, up to about five years. With no dates filled in it covers roughly the last month. No API key required. **Inputs** - From (`from_currency`, text): The currency being converted from. Defaults to the euro. Default: `EUR`. - To (`to_currency`, text): The currency being converted into. Defaults to the Polish złoty. Default: `PLN`. - Start date (`start_date`, date): Optional. The first day to include. Defaults to about a month back. - End date (`end_date`, date): Optional. The last day to include. Defaults to today. **Outputs** - `average` (number): The mean of the rates in the range. Worked out here, not published by NBP - NBP publishes no period averages. - `change` (number): How far the rate moved from the first day to the last, in absolute terms. - `change_percent` (number): The same move as a percentage of where it started. Negative when it fell. - `count` (number): How many rates came back. - `direction` (text): Which way the rate moved: up, down or unchanged. - `end_date` (text): The last day that had a rate. - `first_rate` (number): The rate at the start of the range. - `from_currency` (text): The source currency's three-letter code, such as EUR. - `from_currency_name` (text): NBP's own name for the source currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. - `high` (number): The highest rate in the range. - `high_date` (text): When the highest rate was. - `last_rate` (number): The rate at the end of the range. - `low` (number): The lowest rate in the range. - `low_date` (text): When the lowest rate was. - `rates` (list): Every rate in the range, oldest first. - `requested_end_date` (text): The last day that was asked for. - `requested_start_date` (text): The first day that was asked for. It differs from the first day with a rate whenever the range opens on a weekend or a holiday. - `start_date` (text): The first day that had a rate. - `tables` (text): Which of NBP's tables the rate came from: A for a convertible currency, B for a less common one. A crossed rate names both. - `to_currency` (text): The target currency's three-letter code, such as EUR. - `to_currency_name` (text): NBP's own name for the target currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. **Example output** ```json { "average": 4.2341, "change": -0.0117, "change_percent": -0.28, "count": 3, "direction": "down", "end_date": "2026-09-11", "first_rate": 4.2401, "from_currency": "EUR", "from_currency_name": "euro", "high": 4.2401, "high_date": "2026-09-09", "last_rate": 4.2284, "low": 4.2284, "low_date": "2026-09-11", "rates": [ { "date": "2026-09-09", "rate": 4.2401 }, { "date": "2026-09-10", "rate": 4.2338 }, { "date": "2026-09-11", "rate": 4.2284 } ], "requested_end_date": "2026-09-11", "requested_start_date": "2026-09-09", "start_date": "2026-09-09", "tables": "A", "to_currency": "PLN", "to_currency_name": "z\u0142oty polski" } ``` ### Get a whole rate table Get one of NBP's published tables in full - every currency in it, in one step, exactly as published. Table A is the average rates of the convertible currencies, published every working day; table B is the average rates of the less common ones, published weekly on Wednesdays; table C is the buy and sell prices of about eleven major currencies. Every rate is against the złoty. For a rate between two other currencies, use 'Get an exchange rate'. No API key required. **Inputs** - Table (`table`, text): Which of NBP's three tables to fetch. One of: `A` (Table A - average rates of convertible currencies (every working day)), `B` (Table B - average rates of other currencies (weekly, on Wednesdays)), `C` (Table C - buy and sell rates of major currencies (every working day)). Default: `A`. - Date (`on_date`, date): Optional. The day to use the rate from. NBP publishes on working days only, so a weekend or a Polish public holiday uses the last rate published before it - the one still in force. Leave empty for the latest rate. **Outputs** - `base_currency` (text): Always PLN: every rate here is how many złoty one unit of the quoted currency buys. - `currency_count` (number): How many currencies were published. - `effective_date` (text): The day this publication took effect, as YYYY-MM-DD. - `quotes` (text): What each row carries: 'average' for tables A and B, which give one rate, or 'buy and sell' for table C, which gives two. - `rates` (list): One entry per currency, in alphabetical order by code - the shape to loop over or put in a table. Tables A and B carry 'rate'; table C carries 'bid' and 'ask' instead. - `rates_by_currency` (object): The same average rates keyed by currency code, for looking one up without searching the list. Empty for table C, which quotes two numbers per currency and so cannot be reduced to one lookup - read its eleven rows out of 'rates' instead. - `requested_date` (text): The date that was asked for, or empty when the latest rate was asked for. Compare it with the rate's own date to see whether NBP published that day. - `table` (text): Which table this is: A, B or C. - `table_label` (text): What the table holds, in words. - `table_number` (text): NBP's own number for the publication, such as 177/A/NBP/2026 - the reference a Polish invoice or tax filing cites. A crossed rate names both publications. - `trading_date` (text): For table C only: the day the market was read, which is the working day before the prices took effect. Empty for tables A and B. **Example output** ```json { "base_currency": "PLN", "currency_count": 3, "effective_date": "2026-09-11", "quotes": "average", "rates": [ { "currency": "EUR", "currency_name": "euro", "rate": 4.2284 }, { "currency": "GBP", "currency_name": "funt szterling", "rate": 4.9271 }, { "currency": "USD", "currency_name": "dolar ameryka\u0144ski", "rate": 3.6478 } ], "rates_by_currency": { "EUR": 4.2284, "GBP": 4.9271, "USD": 3.6478 }, "requested_date": "", "table": "A", "table_label": "Table A - average rates of convertible currencies (every working day)", "table_number": "177/A/NBP/2026", "trading_date": "" } ``` ### Get an exchange rate Get the National Bank of Poland's official average exchange rate between two currencies - the latest one, the one in force on a date you name, or the one published the working day before, which is the basis Polish tax law uses. Comes back with the rate both ways round and with NBP's own table number, which is the reference a Polish invoice cites. No API key required. **Inputs** - From (`from_currency`, text): The currency being converted from. Defaults to the euro. Default: `EUR`. - To (`to_currency`, text): The currency being converted into. Defaults to the Polish złoty. Default: `PLN`. - Date (`on_date`, date): Optional. The day to use the rate from. NBP publishes on working days only, so a weekend or a Polish public holiday uses the last rate published before it - the one still in force. Leave empty for the latest rate. - Which rate (`rate_basis`, text): Which publication to take the rate from. 'The rate in force on that day' is the plain reading of a date. 'The last rate published before that day' is what Polish tax law asks for when converting an invoice or a tax obligation - a different figure on every day NBP publishes. One of: `in_force` (The rate in force on that day), `previous_day` (The last rate published before that day). Default: `in_force`. **Outputs** - `from_currency` (text): The source currency's three-letter code, such as EUR. - `from_currency_name` (text): NBP's own name for the source currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. - `inverse_rate` (number): The rate the other way round, for when the answer is needed as 'how many euros to the złoty'. - `is_published_rate` (true/false): True when NBP published this exact figure, which it does for every rate into the złoty. False when it was worked out here by division - a rate out of the złoty, or a cross between two foreign currencies - in which case it is rounded to six significant figures and is not something NBP itself has stated. - `rate` (number): How many of the 'To' currency one of the 'From' currency bought. - `rate_basis` (text): Which basis was used: in_force or previous_day. - `rate_basis_label` (text): The same thing in words, ready to put on a document. - `rate_date` (text): The day NBP published this rate for, as YYYY-MM-DD. Worth reading whenever a date was asked for: a weekend, a holiday or the invoicing basis all answer with an earlier day. - `requested_date` (text): The date that was asked for, or empty when the latest rate was asked for. Compare it with the rate's own date to see whether NBP published that day. - `summary` (text): The rate as a sentence: '1 EUR = 4.2284 PLN'. - `table` (text): Which of NBP's tables the rate came from: A for a convertible currency, B for a less common one. A crossed rate names both. - `table_number` (text): NBP's own number for the publication, such as 177/A/NBP/2026 - the reference a Polish invoice or tax filing cites. A crossed rate names both publications. - `to_currency` (text): The target currency's three-letter code, such as EUR. - `to_currency_name` (text): NBP's own name for the target currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. **Example output** ```json { "from_currency": "EUR", "from_currency_name": "euro", "inverse_rate": 0.236496, "is_published_rate": true, "rate": 4.2284, "rate_basis": "in_force", "rate_basis_label": "The rate in force on that day", "rate_date": "2026-09-11", "requested_date": "", "summary": "1 EUR = 4.2284 PLN", "table": "A", "table_number": "177/A/NBP/2026", "to_currency": "PLN", "to_currency_name": "z\u0142oty polski" } ``` ### Get buy and sell rates Get what NBP buys and sells a currency at - its table C bid and ask prices, with the spread between them worked out. A different table from the average rates, covering about eleven major currencies, and the one to use when the question is what a conversion actually costs rather than what it is worth on paper. Comes back with the trading date as well as the effective date, because table C quotes the market a day before the prices take effect. No API key required. **Inputs** - Currency (`currency`, text): The currency to price, against the złoty. Table C covers only about eleven major currencies - run 'List currencies' to see which. Default: `USD`. - Date (`on_date`, date): Optional. The day to use the rate from. NBP publishes on working days only, so a weekend or a Polish public holiday uses the last rate published before it - the one still in force. Leave empty for the latest rate. **Outputs** - `ask` (number): What NBP sells one unit of the currency at, in złoty - the higher of the two. - `base_currency` (text): Always PLN: both prices are in złoty. - `bid` (number): What NBP buys one unit of the currency at, in złoty - the lower of the two. - `currency` (text): The quoted currency's three-letter code, such as EUR. - `currency_name` (text): NBP's own name for the quoted currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. - `midpoint` (number): Halfway between the two prices. Close to NBP's own average rate but not the same figure - that one is in table A, and 'Get an exchange rate' is what returns it. - `rate_date` (text): The day NBP published this rate for, as YYYY-MM-DD. Worth reading whenever a date was asked for: a weekend, a holiday or the invoicing basis all answer with an earlier day. - `requested_date` (text): The date that was asked for, or empty when the latest rate was asked for. Compare it with the rate's own date to see whether NBP published that day. - `spread` (number): The gap between them, in złoty: what the round trip costs on one unit. - `spread_percent` (number): The same gap as a percentage of the midpoint. This is the number to compare against a threshold. - `summary` (text): Both prices as a sentence, ready to show someone. - `table` (text): Always C, the table these prices live in. - `table_number` (text): NBP's own number for the publication, such as 177/A/NBP/2026 - the reference a Polish invoice or tax filing cites. A crossed rate names both publications. - `trading_date` (text): The day the market was read, which is the working day before these prices took effect. **Example output** ```json { "ask": 3.6843, "base_currency": "PLN", "bid": 3.6113, "currency": "USD", "currency_name": "dolar ameryka\u0144ski", "midpoint": 3.6478, "rate_date": "2026-09-11", "requested_date": "", "spread": 0.073, "spread_percent": 2.0, "summary": "NBP buys 1 USD at 3.6113 PLN and sells at 3.6843 PLN", "table": "C", "table_number": "177/C/NBP/2026", "trading_date": "2026-09-10" } ``` ### Get gold prices over time Get NBP's gold price across a stretch of time, with the high, the low, the average and how far it moved - for a chart, a trend, or a condition on the move. NBP answers at most 93 days per request; this step splits a longer range across as many requests as it takes, up to about five years. With no dates filled in it covers roughly the last month. Gold prices start on 2 January 2013. No API key required. **Inputs** - Start date (`start_date`, date): Optional. The first day to include. Defaults to about a month back. - End date (`end_date`, date): Optional. The last day to include. Defaults to today. **Outputs** - `average` (number): The mean of the prices in the range, worked out here rather than published by NBP. - `change` (number): How far the price moved from the first day to the last, in złoty per gram. - `change_percent` (number): The same move as a percentage. Negative when it fell. This is the number to compare against a threshold. - `count` (number): How many prices came back. - `currency` (text): Always PLN: NBP prices gold in złoty. - `direction` (text): up, down or unchanged. - `end_date` (text): The last day that had a price. - `fineness` (number): Always 1000 - these are prices of pure gold. - `first_price` (number): The price at the start of the range. - `high` (number): The highest price in the range. - `high_date` (text): When the highest price was. - `last_price` (number): The price at the end of the range. - `low` (number): The lowest price in the range. - `low_date` (text): When the lowest price was. - `prices` (list): Every price in the range, oldest first. - `requested_end_date` (text): The last day that was asked for. - `requested_start_date` (text): The first day that was asked for. - `start_date` (text): The first day that had a price. - `summary` (text): The move as a sentence, ready to show someone. **Example output** ```json { "average": 460.18, "change": 4.25, "change_percent": 0.93, "count": 3, "currency": "PLN", "direction": "up", "end_date": "2026-09-11", "fineness": 1000, "first_price": 458.12, "high": 462.37, "high_date": "2026-09-11", "last_price": 462.37, "low": 458.12, "low_date": "2026-09-09", "prices": [ { "date": "2026-09-09", "price_per_gram": 458.12 }, { "date": "2026-09-10", "price_per_gram": 460.05 }, { "date": "2026-09-11", "price_per_gram": 462.37 } ], "requested_end_date": "2026-09-11", "requested_start_date": "2026-09-09", "start_date": "2026-09-09", "summary": "1 g of gold cost 462.37 PLN on 2026-09-11, up 0.93% from 458.12 on 2026-09-09" } ``` ### Get the gold price Get the price the National Bank of Poland calculates for gold - the official figure, published every working day since 2013. NBP quotes one gram of pure gold in złoty; this step gives that figure and works out the troy ounce and the kilogram beside it, so it can be compared with any other gold price in the world. Ask for it in another currency and it is converted at NBP's own average rate for the same day. No API key required. **Inputs** - Date (`on_date`, date): Optional. The day to use the rate from. NBP publishes on working days only, so a weekend or a Polish public holiday uses the last rate published before it - the one still in force. Leave empty for the latest rate. - Price in (`currency`, text): Optional. The currency to quote the price in, converted at NBP's average rate for the same day. Defaults to the złoty, which is what NBP publishes. Default: `PLN`. **Outputs** - `currency` (text): The quoted currency's three-letter code, such as EUR. - `currency_name` (text): NBP's own name for the quoted currency. NBP publishes in Polish, so this is the Polish name - 'dolar amerykański' for the US dollar - which is the name a Polish invoice or ledger uses. - `date` (text): The day NBP published this price for, as YYYY-MM-DD. - `exchange_rate` (number): The rate used to convert out of złoty, or 0 when the price was left in złoty. - `exchange_rate_date` (text): The day that rate was published for, or empty when no conversion was needed. - `fineness` (number): Always 1000: NBP prices gold of 1000 millesimal fineness, which is pure gold. A 14-carat price is this one scaled by its own fineness. - `price_per_gram` (number): The price of one gram, in the chosen currency. - `price_per_gram_pln` (number): The figure NBP published, in złoty per gram, untouched - the citable number, whatever currency was asked for. - `price_per_kilogram` (number): The price of one kilogram. - `price_per_ounce` (number): The price of one troy ounce (31.1034768 g), which is the unit gold is quoted in everywhere outside Poland. - `requested_date` (text): The date that was asked for, or empty when the latest rate was asked for. Compare it with the rate's own date to see whether NBP published that day. - `summary` (text): The price as a sentence, ready to show someone. **Example output** ```json { "currency": "PLN", "currency_name": "z\u0142oty polski", "date": "2026-09-11", "exchange_rate": 0.0, "exchange_rate_date": "", "fineness": 1000, "price_per_gram": 462.37, "price_per_gram_pln": 462.37, "price_per_kilogram": 462370.0, "price_per_ounce": 14381.31, "requested_date": "", "summary": "1 g of gold cost 462.37 PLN on 2026-09-11" } ``` ### List currencies List every currency NBP quotes against the złoty right now, with NBP's own name for each and which table it is in. Takes nothing. The step that answers the one thing the others quietly need: a currency is in table A or in table B, never both, and only about eleven have buy and sell prices at all. Use it to check a code before converting, or to give an AI step the list to choose from. No API key required. **Inputs**: None. **Outputs** - `buy_sell_codes` (list): Just the codes table C quotes buy and sell prices for - the roughly eleven that 'Get buy and sell rates' can answer for. - `codes` (list): Just the codes, for checking whether one is in the list. - `count` (number): How many currencies there are, the złoty included. - `currencies` (list): The złoty first, because it is what every rate is quoted against, then the rest alphabetically by code. - `table_a_date` (text): The day the table A publication this list was read from took effect. - `table_b_date` (text): The same for table B, which is published weekly and so is normally an earlier day. - `table_c_date` (text): The same for table C. **Example output** ```json { "buy_sell_codes": [ "EUR", "USD" ], "codes": [ "PLN", "AFN", "EUR", "THB", "USD" ], "count": 5, "currencies": [ { "code": "PLN", "has_buy_sell": false, "name": "z\u0142oty polski", "table": "" }, { "code": "AFN", "has_buy_sell": false, "name": "afgani (Afganistan)", "table": "B" }, { "code": "EUR", "has_buy_sell": true, "name": "euro", "table": "A" }, { "code": "THB", "has_buy_sell": false, "name": "bat (Tajlandia)", "table": "A" }, { "code": "USD", "has_buy_sell": true, "name": "dolar ameryka\u0144ski", "table": "A" } ], "table_a_date": "2026-09-11", "table_b_date": "2026-09-09", "table_c_date": "2026-09-11" } ```