Python (SDK)

from compass_api_sdk import CompassAPI, models


with CompassAPI(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api:

    res = compass_api.bridge.cctp_burn(owner="0x01E62835dd7F52173546A325294762143eE4a882", chain=models.DepositForBurnRequestChain.ARBITRUM, amount="3", destination_chain=models.DestinationChain.BASE, gas_sponsorship=True, transfer_mode=models.DepositForBurnRequestTransferMode.STANDARD)

    # Handle response
    print(res)

{
  "transaction": {
    "chainId": "<string>",
    "data": "<string>",
    "from": "<string>",
    "gas": "<string>",
    "to": "<string>",
    "value": "<string>",
    "nonce": "<string>",
    "maxFeePerGas": "<string>",
    "maxPriorityFeePerGas": "<string>"
  },
  "eip_712": {
    "domain": {
      "chainId": 123,
      "verifyingContract": "<string>"
    },
    "types": {
      "EIP712Domain": [
        {
          "name": "<string>",
          "type": "<string>"
        }
      ],
      "SafeTx": [
        {
          "name": "<string>",
          "type": "<string>"
        }
      ]
    },
    "primaryType": "<string>",
    "message": {
      "to": "<string>",
      "value": "<string>",
      "data": "<string>",
      "operation": 0,
      "safeTxGas": "<string>",
      "baseGas": "<string>",
      "gasPrice": "<string>",
      "gasToken": "<string>",
      "refundReceiver": "<string>",
      "nonce": "<string>"
    }
  },
  "transfer_mode": "fast",
  "estimated_time_seconds": 123,
  "bridge_id": "br_a1b2c3d4e5f6",
  "fee": 0.01
}

Bridge

Initiate USDC bridging

Bridge USDC to any chain for any Product account using Circle’s CCTP Protocol.

Transfer modes:

standard (default): ~15-19 minute transfers, free (no fee)
fast: ~30 second transfers, requires a small fee (typically ~0.01%)

The fee for fast mode is automatically calculated based on Circle’s current rates.

Flow:

Call this endpoint with gas_sponsorship=false to get an unsigned transaction, or gas_sponsorship=true to get EIP-712 typed data for gas-sponsored execution
Owner signs the transaction or typed data
Broadcast the transaction on the source chain (or submit to /gas_sponsorship/prepare)
Wait for Circle’s attestation service to attest the burn
Call the mint endpoint to receive USDC on the destination chain

Supported chains:

Ethereum (domain 0)
Arbitrum (domain 3)
Base (domain 6)

Note: The USDC must already be deposited in the Product Account. If approval is needed for the TokenMessengerV2 contract, it will be included in the transaction automatically.

POST

cctp

burn

Python (SDK)

from compass_api_sdk import CompassAPI, models


with CompassAPI(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api:

    res = compass_api.bridge.cctp_burn(owner="0x01E62835dd7F52173546A325294762143eE4a882", chain=models.DepositForBurnRequestChain.ARBITRUM, amount="3", destination_chain=models.DestinationChain.BASE, gas_sponsorship=True, transfer_mode=models.DepositForBurnRequestTransferMode.STANDARD)

    # Handle response
    print(res)

{
  "transaction": {
    "chainId": "<string>",
    "data": "<string>",
    "from": "<string>",
    "gas": "<string>",
    "to": "<string>",
    "value": "<string>",
    "nonce": "<string>",
    "maxFeePerGas": "<string>",
    "maxPriorityFeePerGas": "<string>"
  },
  "eip_712": {
    "domain": {
      "chainId": 123,
      "verifyingContract": "<string>"
    },
    "types": {
      "EIP712Domain": [
        {
          "name": "<string>",
          "type": "<string>"
        }
      ],
      "SafeTx": [
        {
          "name": "<string>",
          "type": "<string>"
        }
      ]
    },
    "primaryType": "<string>",
    "message": {
      "to": "<string>",
      "value": "<string>",
      "data": "<string>",
      "operation": 0,
      "safeTxGas": "<string>",
      "baseGas": "<string>",
      "gasPrice": "<string>",
      "gasToken": "<string>",
      "refundReceiver": "<string>",
      "nonce": "<string>"
    }
  },
  "transfer_mode": "fast",
  "estimated_time_seconds": 123,
  "bridge_id": "br_a1b2c3d4e5f6",
  "fee": 0.01
}

Authorizations

x-api-key

string

header

required

Your Compass API Key. Get your key here.

Body

application/json

owner

string

required

The primary wallet address that owns and controls the Product Account.

chain

enum<string>

required

The source chain where USDC will be burned.

Available options:

ethereum,

arbitrum,

base

amount

required

The amount of USDC to bridge (in token units, e.g., 100.5 for 100.5 USDC).

Required range: x > 0

Example:

100

destination_chain

enum<string>

required

The destination chain where USDC will be minted.

Available options:

ethereum,

arbitrum,

base

gas_sponsorship

boolean

default:false

Optionally request gas sponsorship. If set to true, EIP-712 typed data will be returned that must be signed by the owner and submitted to the 'Prepare gas-sponsored transaction' endpoint (/gas_sponsorship/prepare).

transfer_mode

enum<string>

default:standard

Transfer speed mode. 'fast': ~30 second transfers using confirmed finality (requires a small fee taken from transfer amount). 'standard': ~15-19 minute transfers using full finality (free, no fee). Default is 'standard'.

Available options:

fast,

standard

Response

Successful Response

Response model for CCTP depositForBurn transaction from a smart account.

Contains either an unsigned transaction for direct submission or EIP-712 typed data for gas-sponsored transactions. Also includes a bridge_id for tracking the cross- chain transfer.

transaction

UnsignedTransaction · object

required

Show child attributes

transaction.chainId

string

required

The chain id of the transaction

transaction.data

string

required

The data of the transaction

transaction.from

string

required

The sender of the transaction

transaction.gas

string | null

required

The gas of the transaction

transaction.to

string

required

The recipient of the transaction

transaction.value

string

required

The value of the transaction

transaction.nonce

string

required

The nonce of the address

transaction.maxFeePerGas

string

required

The max fee per gas of the transaction

transaction.maxPriorityFeePerGas

string

required

The max priority fee per gas of the transaction

eip_712

BatchedSafeOperationsResponse · object

required

Response containing EIP-712 typed data for Safe transaction signing.

Show child attributes

eip_712.domain

EIP712Domain · object

required

EIP-712 domain separator

Show child attributes

eip_712.domain.chainId

integer

required

Chain ID for the Safe transaction

eip_712.domain.verifyingContract

string

required

Address of the Safe contract

eip_712.types

EIP712Types · object

required

EIP-712 type definitions

Show child attributes

eip_712.types.EIP712Domain

EIP712DomainField · object[]

required

EIP712Domain type definition

Show child attributes

eip_712.types.EIP712Domain.name

string

required

eip_712.types.EIP712Domain.type

string

required

eip_712.types.SafeTx

SafeTxField · object[]

required

SafeTx type definition

Show child attributes

eip_712.types.SafeTx.name

string

required

eip_712.types.SafeTx.type

string

required

eip_712.primaryType

string

required

Primary type for the structured data

Allowed value: "SafeTx"

eip_712.message

SafeTxMessage · object

required

Safe transaction message data

Show child attributes

eip_712.message.to

string

required

Destination address

eip_712.message.value

string

required

Value in wei as a string

eip_712.message.data

string

required

Transaction data as hex string

eip_712.message.operation

enum<integer>

required

Operation type (0=Call, 1=DelegateCall)

Available options:

0,

1

eip_712.message.safeTxGas

string

required

Gas for the Safe transaction

eip_712.message.baseGas

string

required

Base gas costs

eip_712.message.gasPrice

string

required

Gas price

eip_712.message.gasToken

string

required

Token address for gas payment

eip_712.message.refundReceiver

string

required

Address to receive gas refund

eip_712.message.nonce

string

required

Safe transaction nonce

transfer_mode

enum<string>

required

The transfer speed mode used. 'fast' uses confirmed finality (~30s), 'standard' uses full finality (~15-19 min).

Available options:

fast,

standard

estimated_time_seconds

integer

required

Estimated time to complete the bridge in seconds.

bridge_id

string | null

Unique bridge identifier for tracking this cross-chain transfer. Use this ID when calling /mint/prepare to complete the transfer. Only present when Redis is configured on the server.

Example:

"br_a1b2c3d4e5f6"

fee

string | null

Fee amount in USDC charged for this transfer. Only present for fast mode. Standard mode transfers are free (fee is None or 0).

Example:

0.01

Swap tokens within Earn Account Complete USDC bridging

⌘I

API Reference

Authorizations

Body

Response