Skip to main content
Base URL: https://api.eco.com. One versioned interface for quoting a stablecoin transfer, funding it onchain or gaslessly, tracking delivery, and Circle Gateway fast deposits. Move assets in four calls:
  1. GET /v1/chains and GET /v1/tokens once, to discover what can be quoted.
  2. POST /v1/quotes to price a transfer. The response includes the exact transaction to send.
  3. Fund the quote: send execution.transaction from the funder, or post a signed authorization to a submit endpoint.
  4. GET /v1/intents/status?intentHash=… until the intent is filled.

​
Authentication

The key is sent as an x-api-key header and belongs on a server, never in a browser or mobile app. Partner pricing and features are tied to the key. Contact Eco to get one. Key errors are listed in Errors and retries.

​
Conventions

  • Requests are JSON with Content-Type: application/json. Unknown or misplaced keys are rejected with 400.
  • Amounts are base-unit decimal strings ("1000000" is 1 USDC). Arithmetic belongs in bigint.
  • slippage is a decimal fraction from 0.0001 to 1; 0.005 means 0.5%.
  • Timestamps are Unix seconds.
  • Every discriminator is named type: the quote type (exact-in, exact-out, custom), fees[].type, steps[].type, execution.transaction.type.
  • IDs carry a type prefix (quote:, gasless:, intent:). Status filters quoteId and jobId take the bare UUID.
  • Page size (limit) is 1 to 50, default 20.
  • Circle Gateway deposit-address create and lookup keep a { data: … } envelope and their own error format.
  • Every quote is signed. See Quote verification.