{ "openapi": "3.0.1", "info": { "title": "Currency Exchange Rates: Live, Historical, Convert", "description": "Get live and past exchange rates for 340 currencies and crypto. Convert amounts in bulk, get daily rates for any date range since 1999, and compare sources. Uses official ECB rates, daily community rates and optional live Google Finance rates. Works as a batch run or a live HTTP API.", "version": "0.1", "x-build-id": "tGCbn4aUWMyyxDiDJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apizilla~currency-exchange-rates-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apizilla-currency-exchange-rates-api", "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/apizilla~currency-exchange-rates-api/runs": { "post": { "operationId": "runs-sync-apizilla-currency-exchange-rates-api", "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/apizilla~currency-exchange-rates-api/run-sync": { "post": { "operationId": "run-sync-apizilla-currency-exchange-rates-api", "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", "required": [ "operation" ], "properties": { "operation": { "title": "Operation", "enum": [ "latest", "convert", "historical", "timeseries", "currencies", "crosscheck" ], "type": "string", "description": "What you want to get.", "default": "latest" }, "base": { "title": "Base currency", "type": "string", "description": "The currency you convert from. Example: USD. Used by latest, historical, timeseries and crosscheck.", "default": "USD" }, "targets": { "title": "Target currencies", "type": "array", "description": "The currencies you convert to. One code per line. Example: EUR, GBP, JPY, BTC. For latest and historical, leave empty to get all 30 ECB currencies.", "items": { "type": "string" } }, "conversions": { "title": "Conversions", "type": "array", "description": "Only for convert. A list of amounts to convert. Each item: {\"amount\": 100, \"from\": \"USD\", \"to\": \"EUR\"}. You can add \"date\" (YYYY-MM-DD) for a past rate and \"id\" to match rows to your data." }, "date": { "title": "Date", "type": "string", "description": "For historical: the day you want, like 2020-03-02. For convert: a default date for items with no date. Leave empty for the latest rates." }, "startDate": { "title": "Start date", "type": "string", "description": "Only for timeseries. First day, like 2025-01-01." }, "endDate": { "title": "End date", "type": "string", "description": "Only for timeseries. Last day. Leave empty for today." }, "source": { "title": "Data source", "enum": [ "auto", "ecb", "community", "google" ], "type": "string", "description": "Auto uses official ECB rates for the 30 main currencies and daily community rates for all others. Google gives live rates and costs a bit more.", "default": "auto" }, "maxResults": { "title": "Max rows", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many rows. This keeps your cost under control.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy for Google", "type": "object", "description": "Only used for the Google source and crosscheck. Usually not needed. Turn it on if Google blocks your runs." } } }, "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 } } } } } } } } } }