{ "openapi": "3.0.1", "info": { "title": "NBP & ECB Exchange Rates - Historical Currency Converter", "description": "Get NBP and ECB reference exchange rates, look up historical dates and convert currency amounts. Each result includes the rate date for traceable reporting. Uses public central-bank APIs, not scraped prices. Not a live trading feed or accounting advice.", "version": "0.1", "x-build-id": "XniFzBSMGQvcxbVFp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/danielmichalek~official-fx-rates/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-danielmichalek-official-fx-rates", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/danielmichalek~official-fx-rates/runs": { "post": { "operationId": "runs-sync-danielmichalek-official-fx-rates", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/danielmichalek~official-fx-rates/run-sync": { "post": { "operationId": "run-sync-danielmichalek-official-fx-rates", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "source": { "title": "Source", "enum": [ "NBP", "ECB" ], "type": "string", "description": "NBP: mid rates in PLN per unit of foreign currency (tables A/B), or bid/ask (table C). ECB: euro foreign exchange reference rates (foreign currency per 1 EUR).", "default": "NBP" }, "nbpTable": { "title": "NBP table", "enum": [ "A", "B", "C" ], "type": "string", "description": "Only for source NBP. A = mid rates of major currencies (daily), B = mid rates of other currencies (weekly), C = bid/ask rates (rate list only, not usable for conversions).", "default": "A" }, "currencies": { "title": "Currencies (rate list)", "type": "array", "description": "ISO 4217 codes whose rates should be listed for the date range below. The source's own base currency (PLN for NBP, EUR for ECB) is ignored. Leave empty if you only need conversions.", "items": { "type": "string" } }, "startDate": { "title": "Start date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "First day of the rate list (YYYY-MM-DD). Required when currencies are given." }, "endDate": { "title": "End date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Last day of the rate list (YYYY-MM-DD, inclusive). Defaults to the start date. Maximum range: 3660 days." }, "conversions": { "title": "Amounts to convert", "type": "array", "description": "Objects { \"amount\": 100, \"from\": \"USD\", \"to\": \"PLN\", \"date\": \"YYYY-MM-DD\", \"id\": \"optional\" }. Cross rates are computed via the source's base currency. At most 10000 conversions per run." }, "rateDateMode": { "title": "Rate date rule for conversions", "enum": [ "exact", "onOrBefore", "before" ], "type": "string", "description": "onOrBefore: rate of the given date or the last published before it (weekends/holidays). before: last rate strictly before the date (Polish tax rule: NBP rate from the last business day preceding the transaction). exact: only a rate published on that very date.", "default": "onOrBefore" }, "maxLookbackDays": { "title": "Maximum look-back (days)", "minimum": 0, "maximum": 31, "type": "integer", "description": "How many calendar days back a conversion may search for the last published rate.", "default": 10 }, "decimals": { "title": "Decimals of converted amounts", "minimum": 0, "maximum": 8, "type": "integer", "description": "Converted amounts are rounded half away from zero to this many decimal places.", "default": 2 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }