CCTP V1

CCTP API Hosts and Endpoints V1

API hosts and endpoints for CCTP V1

CCTP V1 provides a set of API hosts and endpoints to manage messages, attestations, and transaction details for your cross-chain USDC transfers.

Environment URL

Testnet https://iris-api-sandbox.circle.com

Mainnet https://iris-api.circle.com

Environment	URL
Testnet	`https://iris-api-sandbox.circle.com`
Mainnet	`https://iris-api.circle.com`

CCTP V1 endpoints allow you to fetch attestations for Standard Transfer burn events, verify public keys, and access transaction details. Below is an overview of the CCTP V1 public endpoints. Click on any endpoint for its API reference.

Endpoint	Description	Use Case
GET /v1/attestations/{messageHash}	Retrieves the signed attestation for a USDC burn event on the source chain.	Certifying the burn of USDC post hard finality. Used as a signal to mint USDC on the destination chain.
GET /v1/publicKeys	Fetches Circle's active public keys for verifying attestation signatures.	Validating the authenticity of Circle's signed attestations.
GET /v1/messages/{sourceDomainId}/{transactionHash}	Provides transaction details for burn events or associated messages.	Accessing detailed information about CCTP V1 transactions.

Endpoint

Description

Use Case

GET /v1/attestations/{messageHash}

Retrieves the signed attestation for a USDC burn event on the source chain.

Certifying the burn of USDC post hard finality. Used as a signal to mint USDC on the destination chain.

GET /v1/publicKeys

Fetches Circle's active public keys for verifying attestation signatures.

Validating the authenticity of Circle's signed attestations.

GET /v1/messages/{sourceDomainId}/{transactionHash}

Provides transaction details for burn events or associated messages.

Accessing detailed information about CCTP V1 transactions.