Skip to main content
REST surface for Gateway Fast Deposits. Create a quoted vault for a specific (sourceChainId, amount, recipient, depositor); fund it gaslessly via ERC-3009 or EIP-2612 Permit, or with a direct transfer; USDC settles into the user’s Circle Gateway balance on Polygon.

​
Base URL

https://api.eco.com All responses are wrapped as { "data": ... } unless otherwise noted.

​
Validation rules

  • EVM addresses: must pass isEthereumAddress (EIP-55 / lowercase hex)
  • sourceChainId / chainId: integer ≥ 1
  • amount / value / validAfter / validBefore: non-negative integer strings
  • nonce: 0x-prefixed 32-byte hex (64 hex chars)
  • signature: 0x-prefixed 65-byte hex (130 hex chars)

​
Endpoints

Use the sidebar to navigate to each endpoint. Two categories: Circle Gateway, create a quoted deposit vault, poll its state. Vault state transitions: PENDING → FUNDING_DETECTED → PUBLISHED, with EXPIRED_UNFUNDED, FAILED, REFUNDED_BY_USER, and RECOVERY_PUBLISHED as the non-happy-path outcomes. Gasless funding, submit a signed ERC-3009 authorization or EIP-2612 Permit; poll the resulting relayer job via GET /circle-gateway/v1/gasless/jobs/{id}. Job status transitions: PENDING → (PERMIT_SENT for Permit only) → COMPLETED | FAILED.