CCTP API hosts and endpoints V1

This is CCTP V1 version. For the latest version, see CCTP.

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

CCTP V1 API Service Hosts

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

CCTP V1 API Endpoints

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 . 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.

API Service Rate LimitThe CCTP V1 API service rate limit is 40 requests per second. If you exceed 40 requests per second, the service blocks all API requests for the next five minutes and returns an HTTP 429 response.

CCTP message format V1

CCTP limits V1

⌘I

​CCTP V1 API Service Hosts

​CCTP V1 API Endpoints

CCTP V1 API Service Hosts

CCTP V1 API Endpoints