# Wise — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Get real-time exchange rates, convert between currencies, and check transfer fees directly from Wise.com. Access live pricing data, supported currency pairs, historical rate trends, and detailed currency information to make informed international money transfer decisions.

**Category:** Finance & Markets | **Website:** [wise.com/](https://wise.com/) | **Docs:** [parse.bot/marketplace/645ac7d9-dce6-444b-ba24-fba2ad9c7c97/wise-com-api](https://parse.bot/marketplace/645ac7d9-dce6-444b-ba24-fba2ad9c7c97/wise-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-wise-com-api-645ac7d9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### convert_currency

Get the converted amount for a specific send amount between two currencies. Returns the recipient amount after fees, the exchange rate used, and the cheapest payment method combination. Includes potential savings compared to banks when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `amount` | number | No | Amount to convert in the source currency |
| `source` | string | Yes | Source currency code (e.g. USD, GBP, EUR) |
| `target` | string | Yes | Target currency code (e.g. EUR, USD, GBP) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wise-com-api-645ac7d9/convert_currency \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":"<number>","source":"<string>","target":"<string>"}'
```

### get_currency_details

Get details about a specific currency including its full name, symbol, a descriptive paragraph, and a live exchange rate table showing rates to and from major world currencies. The rate table typically includes 8 major pairs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `code` | string | Yes | Currency code (e.g. USD, EUR, GBP, AUD) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wise-com-api-645ac7d9/get_currency_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"<string>"}'
```

### get_currency_pairs

Get all available currency conversion pairs for a specific base currency. Returns a list of directional pair strings (e.g. 'USD to EUR', 'EUR to USD') indicating which conversions are supported. Useful for validating whether a specific route exists before attempting a conversion.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `code` | string | Yes | Base currency code (e.g. USD, EUR, GBP, AUD) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wise-com-api-645ac7d9/get_currency_pairs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"<string>"}'
```

### get_exchange_rate

Get the mid-market exchange rate between two currencies. By default returns the current live rate with a 48-hour percentage change. When a date is provided, returns the historical rate for that specific date instead (percentage_change_48h will be null for historical lookups).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Historical date in YYYY-MM-DD format. Must be within the last 5 years. When omitted, returns the current live rate. |
| `source` | string | Yes | Source currency code (e.g. USD, GBP, EUR) |
| `target` | string | Yes | Target currency code (e.g. EUR, USD, GBP) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wise-com-api-645ac7d9/get_exchange_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","source":"<string>","target":"<string>"}'
```

### get_exchange_rate_history

Get historical exchange rate data points for a currency pair over a specified period. Returns timestamped rate values, the current rate, and percentage change over the period. Data point density varies by period: hourly for short periods (1D, 1W, 1M), daily for longer ones (6M, 1Y, 5Y).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period` | string | No | Time period for historical data |
| `source` | string | Yes | Source currency code (e.g. USD, GBP, EUR) |
| `target` | string | Yes | Target currency code (e.g. EUR, USD, GBP) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wise-com-api-645ac7d9/get_exchange_rate_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"<string>","source":"<string>","target":"<string>"}'
```

### get_transfer_fee

Get the full fee breakdown for a money transfer with various payment method combinations. Returns all available pay-in/pay-out method pairs with their respective fees, exchange rates, recipient amounts, and estimated delivery times. Useful for comparing transfer costs across methods.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `amount` | number | No | Amount to send in the source currency |
| `source` | string | Yes | Source currency code (e.g. USD, GBP, EUR) |
| `target` | string | Yes | Target currency code (e.g. EUR, USD, GBP) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wise-com-api-645ac7d9/get_transfer_fee \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":"<number>","source":"<string>","target":"<string>"}'
```

### list_supported_currencies

Get the full list of all currencies supported by Wise. Returns currency code, name, symbol, country keywords for search, and whether the currency supports decimal amounts. Typically returns 50+ currencies.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wise-com-api-645ac7d9/list_supported_currencies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```