currency query parameter to select the currency for monetary values:
- The request’s
?currency=value. - The active ecosystem’s configured currency.
USD.
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.
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 interprets1000000 as one million euros, converts the threshold to USD for the
query, and returns matching amounts in euros:
Aggregates
Monetary aggregate metrics use the requested currency and include it in the response envelope:Fund amounts
Funds are stored in their native currencies. Fund responses convertamount_source.amount from amount_source.currency through USD into the
requested response currency:
amountis the converted value in the top-level responsecurrency.amount_sourcepreserves the original amount and native currency.amountis null if the fund’s native currency has no exchange rate.
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.