Offramp lets your users convert crypto into fiat and send funds directly to a bank account (ACH) or a Coinbase account. Follow these steps to create and complete an offramp transaction:
See it live Check out our Onramp + Offramp Demo App repo.
Create a https://pay.coinbase.com/v3/sell/<params>
URL which you direct your users to. Be sure to include the following parameters:
partnerUserId
: Your App’s unique user identifierredirectUrl
: User will be taken after they submit an offramp transaction (Add your url to your onramp app domain allowlist on CDP portal, Coinbase will validate that this is in your App’s domain allowlist. You can also use localhost domain for testing)addresses
: The address of the user cashing out crypto for fiat. This address must contain the funds to be sold when the offramp transaction is created.sessionToken
: used to securely authenticate users and manage sessions (this is required and will be enforced starting 7/31/2025)Note: Offramp transactions time out 30 mins after users click the “Cash out now” button in the Coinbase widget. Users must perform the onchain send transaction within this time.
Session tokens are now required and will be enforced starting 7/31/2025. The URL should look like this:
partnerUserId
.sell_amount
, asset
, network
, and to_address
to create an onchain send transaction in your App.
to_address
is a Coinbase managed onchain address where send funds to be offrampedfrom_address
, to_address
, amount
, network
, and asset
.
from_address
as it changes after every transaction.Check out our Onramp + Offramp Demo App. Have questions? Drop us a message in the #onramp channel of the CDP Discord!
The Offramp API has the following endpoints:
Method | Description |
---|---|
Session Token | Required starting 7/31/2025: Provides a secure way for the client to initialize the Onramp and Offramp widget. |
Offramp Config | Returns list of countries supported by Coinbase Offramp, and the payment methods available in each country. |
Offramp Options | Returns supported fiat currencies and available crypto assets that can be passed into the Offramp Quote API. |
Offramp Quote | Provides a quote based on the asset the user would like to sell, plus the network, the crypto amount, the cashout currency, payment method, and country. |
Transaction Status | Real time transaction status updates. |
Transactions | Historical transaction status. |
Full API endpoint list
For a complete list of all API endpoints supported by Onramp/Offramp, visit our API Reference section.
The Buy Quote API and Sell Quote API are rate limited to prevent abuse that would degrade our ability to maintain consistent API performance for all users. Throttling is enforced per endpoint by app ID at 10 requests per second.
If your requests are being rate limited, HTTP response code 429 is returned with a rate_limit_exceeded
error.
Rate limiting is implemented using a sliding window algorithm.