Skip to main content

Listing currency

A listing currency is the denomination that items in the listings are priced in.

The settlement currency is the currency which the buyer will pay with and what the seller ultimately receives. The platform supports configuring settlement currency for MINT_VOUCHER as a payment provider. Settlement currency for STRIPE must be configured with the respective payment provider. EMAIL_CLAIM only supports free listings, so no settlement currency is needed.

A listing currency is different from a settlement currency in that there may not always be a 1:1 mapping between the two. The platform provides default settlement currencies for all payment providers. For crypto payment, these will vary per blockchain, see the table below.

For example, if a listing is denominated in ETH and your Stripe integration is configured with USD payments, then the platform will use USD as the settlement currency. At the time of purchase, the platform will take the spot price of ETH and convert the listing price to USD when relaying the payment request to Stripe. Consider a listing priced at 0.5 ETH and the ETH spot price of $1000 USD, a buyer would need to pay $500 USD to purchase the item.

All listings must be denominated in a single currency.

Supported currencies​

The platform currently supports listings to be denominated in three currencies:

  • ETH (Ether) - The native cryptocurrency of the Ethereum network.
  • USD (United States Dollar) - The official currency of the United States of America.
  • EUR (Euro) - The monetary unit and currency of the European Union.

Default settlement currencies​

Stripe​

Listing currencySettlement currency
ETHUSD
USDUSD
EUREUR

Mint Voucher​

Listing currencySettlement currency
ETHETH
USDUSD
EUREUR

Settlement currency can be configured for MINT_VOUCHER as a payment provider when creating a listing. If not set, the platform defaults to the above mapping. For each settlement currency, the platform chooses the following currency contract depending on network.

Settlement currency mapping​

ETH​

Where available, the platform will use the native currency. This is represented as the null address 0x0000000000000000000000000000000000000000.

BlockchainSymbolERC20 Address
MainnetN/A0x0000000000000000000000000000000000000000
LineaN/A0x0000000000000000000000000000000000000000
PolygonWETH0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619
MumbaiWETH0xA6FA4fB5f76172d178d61B04b0ecd319C5d1C0aa

USD​

USDC is a digital dollar, also known as a stablecoin and is issued by Circle under a full-reserve model where every digital dollar of USDC can always be exchanged 1:1 for cash.

BlockchainSymbolERC20 Address
MainnetUSDC0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
LineaUSDC0x176211869cA2b568f2A7D4EE941E073a821EE1ff
PolygonUSDC0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359

EUR​

Euro Coin (EUROC) is issued by Circle under the same full-reserve model as USD Coin (USDC).

BlockchainSymbolERC20 Address
MainnetEUROC0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c
PolygonN/AN/A
GoerliN/AN/A
MumbaiN/AN/A
Last updated on