Skip to main content
REST surface for Solana deposit addresses. The configured factory, destination, and depositor determine the Base deposit address. Eco’s monitoring service detects USDC deposits and submits the intent-creation transactions. This is the static v1 API. Check the guide’s availability and deprecation notes before a new integration.

Base URL

https://deposit-addresses.eco.com Successful create and lookup responses wrap the deposit record as { "data": ... }. Errors use the formats described below.

Authentication

No authentication required.

Validation rules

  • solanaAddress: base58, 32-44 chars, matching ^[1-9A-HJ-NP-Za-km-z]{32,44}$
  • EVM addresses: must pass isEthereumAddress (EIP-55 / lowercase hex)
  • chainId: integer >= 1
Validation failures return 400 with a validationErrors map. Business errors (unknown address, unconfigured chain) also return 400, with a details envelope carrying errorCode and errorDesc.

Endpoints

The OpenAPI document defines both operations. The integration guide includes TypeScript requests, response fields, and error examples. No requests-per-second quota is published. Handle 429 with backoff and honor Retry-After when present.

Next steps