# Wise Currency Converter Helper (`rl1987/wise-currency-converter-helper`) Actor Fetches currency conversion quotes from Wise's public gateway API for multiple currency pairs/amounts in a single run. - **URL**: https://apify.com/rl1987/wise-currency-converter-helper.md - **Developed by:** [R.L.](https://apify.com/rl1987) (community) - **Categories:** Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 output rows This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does Wise Currency Converter Helper do? **Wise Currency Converter Helper** fetches currency conversion quotes from [Wise's](https://wise.com/) public `savings` gateway API for any number of currency pairs and amounts in a single run. Give it a list of source/target currency codes and send amounts, and it returns the raw quote data Wise's own converter widget uses — fees, exchange rate, and converted amount — without opening a browser. Run it once, on a schedule, or trigger it via the Apify API to keep quote data fresh in your own systems. ### Why use Wise Currency Converter Helper? - **Batch quotes** - check dozens of currency pairs/amounts in one run instead of manually loading wise.com for each one. - **Automation-friendly** - schedule runs, call via the Apify API, or wire into Zapier/Make to track rates over time. - **No maintenance** - runs on Apify's infrastructure with monitoring, retries, and structured output built in. ### How to use Wise Currency Converter Helper 1. Open the Actor's **Input** tab. 2. Add one or more entries to the `conversions` array, each with `sourceCurrency`, `targetCurrency`, and `sendAmount`. 3. Optionally set a default `alias` (applied to any conversion that doesn't specify its own). 4. Click **Start** and view results in the **Dataset** tab once the run finishes. ### Input | Field | Type | Description | | --- | --- | --- | | `conversions` | array | List of conversion requests. Each item needs `sourceCurrency`, `targetCurrency`, `sendAmount`, and may override `alias`. | | `alias` | string | Default value for the Wise `alias` query param (default: `wise`). | | `requestDelaySecs` | integer | Delay between consecutive requests, in seconds (default: `1`). | Example input: ```json { "conversions": [ { "sourceCurrency": "GBP", "targetCurrency": "IDR", "sendAmount": 666 }, { "sourceCurrency": "USD", "targetCurrency": "EUR", "sendAmount": 1000 } ] } ```` ### Output Each dataset item contains the request parameters plus the flattened Wise API response: ```json { "sourceCurrency": "GBP", "targetCurrency": "IDR", "sendAmount": 666, "type": "...", "alias": "wise", "value": 28.07, "currency": "GBP", "accuracy": "HIGH" } ``` If a request fails, the item instead contains an `error` field describing the failure so the run doesn't stop for the rest of the batch. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. ### Pricing / Cost estimation This Actor makes one lightweight HTTP request per conversion pair - runs are fast and cheap, typically well within Apify's free tier for reasonable batch sizes. ### Tips - Keep `requestDelaySecs` at 1+ second to avoid rate limiting from Wise. - Batch related pairs into a single run rather than many small runs to save on startup overhead. ### FAQ, disclaimers, and support This Actor calls an undocumented, public endpoint used by Wise's own website widget; Wise may change or restrict it without notice. Use responsibly and in line with Wise's Terms of Service. Report issues via the Actor's Issues tab. # Actor input Schema ## `conversions` (type: `array`): List of currency pairs/amounts to fetch quotes for. Each item: sourceCurrency, targetCurrency, sendAmount (optional: alias). ## `alias` (type: `string`): Default value of the `alias` query param sent to Wise, used for any conversion item that does not set its own `alias`. ## `requestDelaySecs` (type: `integer`): Pause between consecutive Wise API requests to avoid rate limiting. ## Actor input object example ```json { "conversions": [ { "sourceCurrency": "GBP", "targetCurrency": "IDR", "sendAmount": 666 } ], "alias": "wise", "requestDelaySecs": 1 } ``` # Actor output Schema ## `dataset` (type: `string`): Dataset items with the requested pair/amount plus the Wise quote (or an error). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "conversions": [ { "sourceCurrency": "GBP", "targetCurrency": "IDR", "sendAmount": 666 } ] }; // Run the Actor and wait for it to finish const run = await client.actor("rl1987/wise-currency-converter-helper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "conversions": [{ "sourceCurrency": "GBP", "targetCurrency": "IDR", "sendAmount": 666, }] } # Run the Actor and wait for it to finish run = client.actor("rl1987/wise-currency-converter-helper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "conversions": [ { "sourceCurrency": "GBP", "targetCurrency": "IDR", "sendAmount": 666 } ] }' | apify call rl1987/wise-currency-converter-helper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rl1987/wise-currency-converter-helper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Wise Currency Converter Helper", "description": "Fetches currency conversion quotes from Wise's public gateway API for multiple currency pairs/amounts in a single run.", "version": "0.1", "x-build-id": "JB9lxZVrgta9ljYy7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rl1987~wise-currency-converter-helper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rl1987-wise-currency-converter-helper", "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/rl1987~wise-currency-converter-helper/runs": { "post": { "operationId": "runs-sync-rl1987-wise-currency-converter-helper", "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/rl1987~wise-currency-converter-helper/run-sync": { "post": { "operationId": "run-sync-rl1987-wise-currency-converter-helper", "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": [ "conversions" ], "properties": { "conversions": { "title": "Currency conversions", "type": "array", "description": "List of currency pairs/amounts to fetch quotes for. Each item: sourceCurrency, targetCurrency, sendAmount (optional: alias).", "default": [ { "sourceCurrency": "GBP", "targetCurrency": "IDR", "sendAmount": 666 }, { "sourceCurrency": "USD", "targetCurrency": "EUR", "sendAmount": 1000 } ] }, "alias": { "title": "Default alias", "type": "string", "description": "Default value of the `alias` query param sent to Wise, used for any conversion item that does not set its own `alias`.", "default": "wise" }, "requestDelaySecs": { "title": "Delay between requests (seconds)", "minimum": 0, "type": "integer", "description": "Pause between consecutive Wise API requests to avoid rate limiting.", "default": 1 } } }, "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 } } } } } } } } } } ```