Network Fee Transparency

Circle is excited to provide an update to how we display the network fees currently charged for transfers on the Ethereum blockchain.

In an effort to provide more real time transparency for blockchain network fees, Circle will now provide the actual network fee charged for a specific transfer shortly after the transaction is complete. This fee will be provided as a USD-equivalent value and these fees will continue to be billed at the end of the month.

We are looking forward to providing your business with this additional layer of visibility and insight at the time of transaction. These fees will start appearing on August 11th, 2022.

There is nothing required of you at this time around this change. We are excited about these enhancements and the improvements they will bring to our valued partnership.

Webhook Notifications

Fees will be sent in the Transfer notification after the Transfer has completed, retaining the status of complete.

📘

Notifications are sent anytime there is a change to the underlying resource.

{
 "clientId": "f1397191-56e6-42fd-be86-0a7b9bd91522",
 "notificationType": "transfers",
 "version": 1,
 "customAttributes": { "clientId": "f1397191-56e6-42fd-be86-0a7b9bd91522" },
 "transfer": {
   "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
   "source": {
     "type": "wallet",
     "id": "01223456789"
   },
   "destination": {
     "type": "blockchain",
     "address": "0x6c78461B9a9AC4EB45C9FfF87a83999c9ad975fD",
     "chain": "ETH"
   },
   "amount": {
     "amount": "3.14",
     "currency": "USD"
   },
   "fees": [
     {
       "amount": "3.14",
       "currency": "USD",
       "type": "network"
     }
   ],
   "transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
   "status": "complete",
   "createDate": "2022-05-18T15:44:21.665Z"
 }
}

APIs

Once released, the following endpoints will be updated to include a fees array of type TransferFee once the fees are known.

  1. /v1/businessAccount/transfers
  2. /v1/businessAccount/transfers/:id
  3. /v1/transfers
  4. /v1/transfers/:id

📘

Once these changes have gone into effect, our API References will then include fees.

{
 "data": {
   "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
   "source": {
       "type": "wallet",
       "id": "01223456789"
   },
   "destination": {
       "type": "blockchain",
       "address": "0x6c78461B9a9AC4EB45C9FfF87a83999c9ad975fD",
       "chain": "ETH"
   },
   "amount": {
     "amount": "3.14",
     "currency": "USD"
   },
   "fees": [
     {
       "amount": "3.14",
       "currency": "USD",
       "type": "network"
     }
   ],
   "transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
   "status": "complete",
   "createDate": "2022-05-18T15:44:21.665Z"
 }
}

Transfer Fee Schema

Name

Type

Required

Read Only

Description

type

String [Enum]

True

True

Type of fee. Enum values are network.

amount

String

True

True

Magnitude of the amount, in units of the currency, with a ..

currency

String

True

True

Currency code. Enum values are USD.