Being able to quickly and accurately convert between different currencies is crucial. That's where Portal Pay's Conversion feature comes in. Let's explore how you can leverage this powerful tool in your applications.

Endpoints

Portal Pay provides a single, powerful endpoint for all your conversion needs:

POST /conversion

What is a Conversion?

Conversion takes an amount in one currency and tells you what it's worth in another. Whether you're converting between crypto assets, traditional (fiat) currencies, or crossing the crypto-fiat divide, our Conversion tool has you covered.

How It Works

You specify an amount to convert.
You indicate which currency you're converting from.
You specify which currency you're converting to.
Our system does the heavy lifting and returns the converted amount.

Both the from and to currencies are represented by integer IDs. For traditional currencies, we use standard ISO 4217 codes. For cryptocurrencies, we use our own extension of this system.

👍
Pro Tip:
Check out our Currency Codes documentation for a complete list of the IDs you can use for both traditional currencies and cryptocurrencies.

The Magic Behind the Scenes

Portal Pay doesn't just rely on a single source for conversion rates. We've developed a proprietary conversion algorithm that combines data from:

Decentralized oracles like Chainlink and Pyth
Leading decentralized exchanges like 1inch

This multi-source approach ensures you get the most accurate and up-to-date conversion rates possible.

Asset Mapping

All fiat currencies use ISO 4217 identifiers to represent the currency.

You can find details of the Portal Pay currency codes on the Currency Codes documentation.