Skip to main content
Custom Stablecoins allow companies to hold customer or corporate balances in their own branded token and earn revenue on every dollar in circulation. Each token is backed 1:1 by USDC on Coinbase, fully interoperable with USDC and deployable on Base (or any EVM-compatible network) and Solana. This documentation is for technical partners integrating with Custom Stablecoins. You can swap tokens directly onchain via the Stableswapper program, or use the Prime API for centralized conversions and withdrawals through Coinbase Prime.

Use cases

Payments

Power branded payments across your app, platform, or merchant network. Fully backed and instantly redeemable for USDC.

Loyalty and rewards

Hold customer balances in your branded stablecoin, earn rewards on circulating supply and put that revenue back into user incentives or cashback.

Treasury

Run internal settlements and B2B payments while generating revenue on your circulating supply.

DeFi protocols

Integrate a custom stablecoin into your protocol with instant USDC liquidity for users.

Key features

  • 1:1 USDC backing: Fully backed by USDC reserves on Coinbase
  • Instant swaps: Single-transaction settlement
  • Predictable pricing: Fixed 1:1 ratio with no slippage surprises
  • Multi-chain support: Available on EVM chains (Base) and SVM chains (Solana) today, with additional chain support available on request
  • Flexible integration: Use via direct smart contract calls (EVM chains) or Cross-Program Invocation (SVM chains)
  • Multi-decimal support: Automatic normalization between tokens with different decimal precision
  • Prime API support: Convert and withdraw custom stablecoins programmatically via Coinbase Prime

Supported networks

Base (EVM) and Solana (SVM) are supported today. Additional EVM and SVM chains are available on request — contact Coinbase to discuss support for your preferred network.
NetworkVM typeUse caseContract type
Base SepoliaEVMTesting and developmentEVM smart contract
Base MainnetEVMProduction useEVM smart contract
Solana DevnetSVMTesting and developmentAnchor program
Solana MainnetSVMProduction useAnchor program

Onchain conversions

Stableswapper is the onchain liquidity program that powers instant swaps between USDC and any Custom Stablecoin issued through the program. It is deployed on both EVM chains (Base) and SVM chains (Solana), providing the settlement layer partners need to let their users move freely between custom tokens and USDC. Learn how to integrate swaps into your application.

How it works

The Stableswapper program maintains a liquidity pool with reserves for each supported token.
1

User initiates swap

The input token is transferred to the contract
2

Validation

The program checks the allowlist (if enabled), validates slippage protection, and applies any configured fee
3

Settlement

The equivalent amount of the output token is sent to the destination address
Swaps settle atomically in a single transaction at a 1:1 ratio before fees, with automatic decimal normalization between tokens with different precision.

Concepts

ConceptDescription
ERC-20The standard token interface used by all supported stablecoins on Base
AllowlistAn optional on-chain list of authorized addresses. When enabled, only allowlisted addresses can initiate swaps
Fee basis pointsSwap fee expressed in basis points (1 bp = 0.01%)
Decimal normalizationAutomatic conversion between tokens with different decimal precision (e.g., 6 vs 18 decimals)
SlippageThe minimum acceptable output amount (minAmountOut). Protects against fee changes between transaction construction and execution

Prime conversions

Partners with Coinbase Prime accounts can convert between USDC and custom stablecoins using the Prime Conversion API, and withdraw converted tokens to onchain wallets. This path is ideal for institutional workflows and Prime-custodied assets. Learn more in the Prime Conversions guide.

Quickstart

Get up and running with your first swap in 10 minutes

Reference

Swap instruction parameters and accounts

Production Readiness

Helper functions, error handling, and best practices

Key Addresses

Program IDs, contract addresses, and token mints

Prime API

Convert and withdraw custom stablecoins via Coinbase Prime