Currency Conversion
GET
/v1/conversion/{from}/{to}
Retrieve real-time currency conversion rates between any two supported currencies. This endpoint provides the most recent bid/ask quotes and calculates the converted amount based on the current market rate, enabling users to quickly and accurately convert values in both directions (e.g., USD to CAD or CAD to USD).
Use Cases: Cross-border transactions, currency hedging, travel expense planning, dynamic pricing.
Path Parameters
from
string
required
The "from" symbol of the pair.
to
string
required
The "to" symbol of the pair.
Query Parameters
amount
number
The amount to convert, with a decimal.
precision
enum (integer)
The decimal precision of the conversion. Defaults to 2 which is 2 decimal places accuracy.
Response Attributes
converted
number
The result of the conversion.
from
string
The "from" currency symbol.
initialAmount
number
The amount to convert.
last
object
optional
Contains the requested quote data for the specified forex currency pair.
ask
number
The ask price.
bid
number
The bid price.
exchange
integer
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
timestamp
integer
The Unix millisecond timestamp.
request_id
string
A request id assigned by the server.
status
string
The status of this request's response.
symbol
string
The symbol pair that was evaluated from the request.
to
string
The "to" currency symbol.