Skip to main content
Before creating an intent, discover which currency pairs are available and which providers support them.

​
Get Supported Currency Pairs

curl https://api.ramp.gnosis.io/v1/currencies/supported \
  -u "${CLIENT_ID}:${CLIENT_SECRET}"
Response: 
[
  {
    "from": "USD",
    "to": "USDC_GNO",
    "providerIds": ["banxa", "bridge"]
  },
  {
    "from": "EUR",
    "to": "USDC_GNO",
    "providerIds": ["banxa"]
  },
  {
    "from": "USDC_GNO",
    "to": "USD",
    "providerIds": ["bridge"]
  }
]

​
Currency Code Format

TypeFormatExamples
FiatTicker onlyUSD, EUR, GBP
Crypto{TICKER}_{CHAIN}USDC_GNO, USDC_ETH, USDC_BASE

​
Chain Identifiers

ChainIdentifier
Gnosis ChainGNO
EthereumETH
BaseBASE
The currency code format is important when creating intents. Use the exact format returned by this endpoint.

​
Get Available Providers

curl https://api.ramp.gnosis.io/v1/providers \
  -u "${CLIENT_ID}:${CLIENT_SECRET}"
Response: 
[
  {
    "id": "banxa",
    "name": "Banxa",
    "code": "banxa",
    "logo": "https://..."
  },
  {
    "id": "bridge",
    "name": "Bridge",
    "code": "bridge",
    "logo": "https://..."
  }
]

​
Selecting a Provider

When creating an intent, you can either:
  1. Let Gnosis Ramp choose — Omit providerId and the system selects the best available provider
  2. Specify a provider — Include providerId at the root level of the intent request
{
  "src": {...},
  "dest": {...},
  "srcAmount": "100.00",
  "providerId": "bridge"  // Optional - at root level
}
The providerId goes at the root level of the intent request, not inside src.details or dest.details.

​
Next Steps

Get Requirements

Learn what fields are needed for your currency pair.

Create an Intent

Start a ramp operation.