Get USDC transfer fees

Retrieves the applicable fees for a USDC transfer between the specified source and destination domains. The fee is returned in basis points (1 = 0.01%).

GET /v2/burn/USDC/fees/{sourceDomainId}/{destDomainId}

Get USDC transfer fees

cURL

curl --request GET \
  --url https://iris-api-sandbox.circle.com/v2/burn/USDC/fees/{sourceDomainId}/{destDomainId}

200

[
  {
    "finalityThreshold": 1000,
    "minimumFee": 1,
    "forwardFee": {
      "low": 90,
      "medium": 110,
      "high": 160
    }
  },
  {
    "finalityThreshold": 2000,
    "minimumFee": 0,
    "forwardFee": {
      "low": 90,
      "medium": 110,
      "high": 160
    }
  }
]

Path Parameters

sourceDomainId · integer · required

Source domain identifier for a blockchain on CCTP.

Required range: x >= 0

Example:

3

destDomainId · integer · required

Destination domain identifier for a blockchain on CCTP.

Required range: x >= 0

Example:

3

Query Parameters

forward · boolean · default: false

Whether to include fees for using the Circle Forwarder in the return value.

hyperCoreDeposit · boolean · default: false

Whether to include the forwarding fee for depositing into HyperCore in the return value. This parameter should only be used if the forward parameter is set to true and the destination domain is HyperEVM.

Response

200

application/json

Successfully retrieved the USDC transfer fees.

finalityThreshold · integer · required

The finality threshold, such as block confirmations, used to determine whether the transfer qualifies as a Fast or Standard Transfer.

minimumFee · number · required

Minimum fees for the transfer, expressed in basis points (bps). For example, 1 = 0.01%.

forwardFee · object

Gas and forwarding fees for using the Circle Forwarder in USDC minor units.

Show child attributes

Example:

[
  {
    "finalityThreshold": 1000,
    "minimumFee": 1,
    "forwardFee": { "low": 90, "medium": 110, "high": 160 }
  },
  {
    "finalityThreshold": 2000,
    "minimumFee": 0,
    "forwardFee": { "low": 90, "medium": 110, "high": 160 }
  }
]