{ "openapi": "3.0.1", "info": { "title": "Currency Exchange Rates Scraper - ECB Reference Rates & History", "description": "Official ECB euro foreign exchange reference rates for about 30 currencies since 1999: the latest day or any date range, against EUR or any base currency (cross rates computed via EUR and marked as computed). One row per day and currency with the ECB series key. No API key.", "version": "0.1", "x-build-id": "EKADoibhVXfI78TXl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~currency-exchange-rates-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-currency-exchange-rates-scraper", "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/neverempty~currency-exchange-rates-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-currency-exchange-rates-scraper", "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/neverempty~currency-exchange-rates-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-currency-exchange-rates-scraper", "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": { "currencies": { "title": "Currencies", "type": "array", "description": "Three-letter ISO 4217 codes, for example USD, JPY, GBP, CHF. Leave empty to get every currency the ECB publishes a reference rate for (about 30 today; older ones such as RUB or HRK when your dates cover them). A code the ECB does not publish is reported in its own row, which is not charged.", "items": { "type": "string" } }, "baseCurrency": { "title": "Base currency", "type": "string", "description": "The currency each rate is quoted against: 1 base = rate x quote. The ECB publishes rates against the euro only, so for any other base (for example USD) every rate is a cross rate computed from the two ECB euro rates of the same day; those rows say rateIsComputed = true and show the calculation and both ECB values.", "default": "EUR" }, "startDate": { "title": "From date", "type": "string", "description": "YYYY-MM-DD. Returns every ECB reference day from this date on (the series start on 1999-01-04). Leave empty, together with To date, to get only the latest reference days." }, "endDate": { "title": "To date", "type": "string", "description": "YYYY-MM-DD, included. Leave empty to go up to the latest published day. Needs From date." }, "latestDays": { "title": "Latest reference days", "minimum": 1, "maximum": 500, "type": "integer", "description": "Used when no dates are given: how many of the most recent ECB reference days to return per currency. 1 gives the latest published rates. Weekends and TARGET holidays have no rates, so 5 days usually cover one working week.", "default": 1 }, "maxResults": { "title": "Maximum rows", "minimum": 1, "maximum": 300000, "type": "integer", "description": "The most rate rows one run returns. Leave empty for the default: 1,000 when Currencies is empty (all currencies), 10,000 when you name currencies. Rows = currencies x ECB reference days: all currencies over one year is about 7,500 rows, one currency since 1999 about 7,100. With all currencies the newest dates come first, so a limit only drops the oldest dates; a row says which dates were not returned." } } }, "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 } } }, "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 } } } } } } } } } }