> ## Documentation Index
> Fetch the complete documentation index at: https://developers.beta.dealroom.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Currencies

> Request monetary fields, filters, and aggregate metrics in one of the currencies supported by the Dealroom API.

Use the `currency` query parameter to select the currency for monetary values:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.beta.dealroom.app/data/companies?currency=EUR&limit=10" \
    -H "Authorization: Bearer $ACCESS_TOKEN" \
    -H "X-Client-Id: YOUR_CLIENT_ID"
  ```

  ```batch Windows CMD theme={null}
  curl "https://api.beta.dealroom.app/data/companies?currency=EUR&limit=10" ^
    -H "Authorization: Bearer %ACCESS_TOKEN%" ^
    -H "X-Client-Id: YOUR_CLIENT_ID"
  ```

  ```powershell PowerShell theme={null}
  $headers = @{
    Authorization = "Bearer $accessToken"
    "X-Client-Id" = "YOUR_CLIENT_ID"
  }

  Invoke-RestMethod -Uri "https://api.beta.dealroom.app/data/companies?currency=EUR&limit=10" -Headers $headers
  ```
</CodeGroup>

Currency codes are case-insensitive and returned in uppercase. The active
currency is resolved in this order:

1. The request's `?currency=` value.
2. The active ecosystem's configured currency.
3. `USD`.

The response includes a top-level `currency` field so clients always know which
unit the monetary values use.

## Supported currencies

| Code  | Currency           | Code  | Currency               |
| ----- | ------------------ | ----- | ---------------------- |
| `AED` | UAE Dirham         | `ARS` | Argentine Peso         |
| `AUD` | Australian Dollar  | `BDT` | Bangladesh Taka        |
| `BRL` | Brazilian Real     | `BWP` | Botswana Pula          |
| `CAD` | Canadian Dollar    | `CHF` | Swiss Franc            |
| `CLP` | Chilean Peso       | `CNY` | Chinese Yuan           |
| `COP` | Colombian Peso     | `CZK` | Czech Koruna           |
| `DKK` | Danish Krone       | `EGP` | Egyptian Pound         |
| `GBP` | Pound Sterling     | `HKD` | Hong Kong Dollar       |
| `HRK` | Croatian Kuna      | `HUF` | Hungarian Forint       |
| `IDR` | Indonesian Rupiah  | `ILS` | Israeli Shekel         |
| `INR` | Indian Rupee       | `ISK` | Icelandic Krona        |
| `JOD` | Jordanian Dinar    | `JPY` | Japanese Yen           |
| `KES` | Kenyan Shilling    | `KRW` | South Korean Won       |
| `MAD` | Moroccan Dirham    | `MYR` | Malaysian Ringgit      |
| `NOK` | Norwegian Krone    | `NZD` | New Zealand Dollar     |
| `OMR` | Omani Rial         | `PEN` | Peruvian Sol           |
| `PHP` | Philippine Peso    | `PLN` | Polish Zloty           |
| `QAR` | Qatari Riyal       | `RSD` | Serbian Dinar          |
| `RUB` | Russian Ruble      | `SAR` | Saudi Arabian Riyal    |
| `SDG` | Sudanese Pound     | `SEK` | Swedish Krona          |
| `SGD` | Singapore Dollar   | `THB` | Thai Baht              |
| `TRY` | Turkish Lira       | `TWD` | Taiwan Dollar          |
| `UAH` | Ukrainian Hryvnia  | `USD` | US Dollar              |
| `VEF` | Venezuelan Bolivar | `XOF` | West African CFA franc |
| `ZAR` | South African Rand |       |                        |

An unsupported code returns `400 VALIDATION_ERROR`:

```json theme={null}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Unsupported currency: BGN"
  }
}
```

## Response conversion

Monetary fields are converted in place. The API does not add currency-specific
siblings such as `_eur` or `_gbp`, and null values remain null.

Conversion applies to monetary values across:

* Company, entity, founder, person, investor, and university responses.
* Funding rounds, valuations, funds, news, and company financials.
* Nested company summaries, investor portfolio entries, and company funding
  and valuation sub-resources.
* Monetary aggregate metrics and monetary time-series values.

For example, `latest_valuation.value`, `total_funding`, funding-round `amount`,
valuation `value`, and financial `revenue` are returned in the response's
top-level `currency`.

Amounts are whole currency units. The source data stores whole USD amounts, and
converted responses are rounded to the nearest whole target-currency unit.

## Monetary filters

The same currency applies to supported monetary filter values. This request
interprets `1000000` as one million euros, converts the threshold to USD for the
query, and returns matching amounts in euros:

<CodeGroup>
  ```bash cURL theme={null}
  curl -g "https://api.beta.dealroom.app/data/companies?currency=EUR&filter=total_funding[gte]:1000000" \
    -H "Authorization: Bearer $ACCESS_TOKEN" \
    -H "X-Client-Id: YOUR_CLIENT_ID"
  ```

  ```batch Windows CMD theme={null}
  curl -g "https://api.beta.dealroom.app/data/companies?currency=EUR&filter=total_funding[gte]:1000000" ^
    -H "Authorization: Bearer %ACCESS_TOKEN%" ^
    -H "X-Client-Id: YOUR_CLIENT_ID"
  ```

  ```powershell PowerShell theme={null}
  $headers = @{
    Authorization = "Bearer $accessToken"
    "X-Client-Id" = "YOUR_CLIENT_ID"
  }

  $query = @{
    currency = "EUR"
    filter   = "total_funding[gte]:1000000"
  }

  Invoke-RestMethod -Method Get -Uri "https://api.beta.dealroom.app/data/companies" -Headers $headers -Body $query
  ```
</CodeGroup>

Monetary filter values must be integers. The API rounds converted boundaries in
the direction required to preserve the requested comparison.

## Aggregates

Monetary aggregate metrics use the requested currency and include it in the
response envelope:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.beta.dealroom.app/analytics/aggregate/funding-rounds?metric=sum:amount&group_by=year&currency=EUR" \
    -H "Authorization: Bearer $ACCESS_TOKEN" \
    -H "X-Client-Id: YOUR_CLIENT_ID"
  ```

  ```batch Windows CMD theme={null}
  curl "https://api.beta.dealroom.app/analytics/aggregate/funding-rounds?metric=sum:amount&group_by=year&currency=EUR" ^
    -H "Authorization: Bearer %ACCESS_TOKEN%" ^
    -H "X-Client-Id: YOUR_CLIENT_ID"
  ```

  ```powershell PowerShell theme={null}
  $headers = @{
    Authorization = "Bearer $accessToken"
    "X-Client-Id" = "YOUR_CLIENT_ID"
  }

  Invoke-RestMethod -Uri "https://api.beta.dealroom.app/analytics/aggregate/funding-rounds?metric=sum:amount&group_by=year&currency=EUR" -Headers $headers
  ```
</CodeGroup>

See [Analytics and aggregates](/concepts/aggregates) for the full request model.

## Fund amounts

Funds are stored in their native currencies. Fund responses convert
`amount_source.amount` from `amount_source.currency` through USD into the
requested response currency:

* `amount` is the converted value in the top-level response `currency`.
* `amount_source` preserves the original amount and native currency.
* `amount` is null if the fund's native currency has no exchange rate.

The fund `amount` filter is an exception. It compares each fund's native amount,
so it is not suitable for a single threshold across funds with mixed native
currencies. See [Known limitations](/concepts/known-limitations#fund-size-filters-use-each-funds-native-currency).

## Further reading

<CardGroup cols={2}>
  <Card title="Analytics and aggregates" icon="chart-bar" href="/concepts/aggregates">
    Apply a requested currency to aggregate monetary metrics.
  </Card>

  <Card title="Known limitations" icon="circle-exclamation" href="/concepts/known-limitations">
    Check the exceptions that affect mixed-currency fund comparisons.
  </Card>
</CardGroup>