Skip to main content
Use the currency query parameter to select the currency for monetary values:
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

An unsupported code returns 400 VALIDATION_ERROR:

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:
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:
See Analytics and 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.

Further reading

Analytics and aggregates

Apply a requested currency to aggregate monetary metrics.

Known limitations

Check the exceptions that affect mixed-currency fund comparisons.