{ "openapi": "3.0.1", "info": { "title": "Currency Rates Scraper — Live & Historical Exchange Rates, FX", "description": "Currency exchange rates without an API key: today's rates for 165 currencies, or the European Central Bank's daily series back to 1999 — one row per pair per day, week, month or year, with the inverse rate, a converted amount and the move in percent. CSV/JSON export and API.", "version": "0.1", "x-build-id": "3JButRqAAkwgfZNy7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chorelet~currency-rates-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chorelet-currency-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/chorelet~currency-rates-scraper/runs": { "post": { "operationId": "runs-sync-chorelet-currency-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/chorelet~currency-rates-scraper/run-sync": { "post": { "operationId": "run-sync-chorelet-currency-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": { "baseCurrencies": { "title": "Base currencies", "type": "array", "description": "The currency each rate is quoted from — `USD` means one US dollar buys this much. One request per base, so a watchlist of ten costs ten requests.", "default": [ "USD" ], "items": { "type": "string" } }, "quoteCurrencies": { "title": "Quote currencies", "type": "array", "description": "The currencies to price the base in. Leave it empty for every currency the source publishes — 29 from the ECB, 165 from the global source.", "items": { "type": "string" } }, "dateFrom": { "title": "From date", "type": "string", "description": "Empty = the latest rates. Otherwise a day (`2020-01-01`) or an offset (`30 days`, `last 6 months`, `5 years`). The ECB series starts on 1999-01-04.", "default": "" }, "dateTo": { "title": "To date", "type": "string", "description": "Last day of the range; empty means today. On its own it asks for that single day — the rate on 15 June 2020, say.", "default": "" }, "interval": { "title": "Interval", "enum": [ "daily", "weekly", "monthly", "yearly" ], "type": "string", "description": "`daily` keeps every published day. The others collapse the series into one row per week, month or year, dated by the period's last trading day, with the period's open, high, low and average next to it.", "default": "daily" }, "amount": { "title": "Amount to convert", "minimum": 1, "type": "integer", "description": "Fills the `converted` column: this many units of the base currency in the quote currency, multiplied out of the unrounded rate.", "default": 1 }, "source": { "title": "Source", "enum": [ "auto", "ecb", "global" ], "type": "string", "description": "`ecb` — the European Central Bank's reference rates (29 currencies, daily history since 1999). `global` — an open feed of 165 currencies, today only. `auto` picks the ECB whenever dates are involved or every currency asked for is one it publishes.", "default": "auto" }, "maxRows": { "title": "Maximum rows", "minimum": 1, "maximum": 500000, "type": "integer", "description": "A safety net for wide date ranges — 27 years of daily history is about 7,100 rows per pair. The run logs how many rows it had to leave behind.", "default": 10000 } } }, "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 } } } } } } } } } }