> ## Documentation Index > Fetch the complete documentation index at: https://docs.eco.com/llms.txt > Use this file to discover all available pages before exploring further. # Track a gasless deposit job > Returns the state of a deposit address or a gasless funding job. Always 200; unknown IDs report status unknown. Returns the state of a deposit address (`address`) or a gasless funding job (`jobId`). One filter is required. Always `200`; an unknown address or job is reported with `status: "unknown"`. Job status covers the funding transaction; the deposit lookup covers the deposit itself. No API key is required: Circle Gateway operations are open so that any wallet or relay can create and fund a deposit address. A supplied key that is unknown, revoked, or not enabled for v1 is still rejected with `401 invalid-api-key`, so send no key rather than a wrong one. No requests-per-second quota is published. Handle `429` and honor `Retry-After` when present. Examples use real mainnet token and contract addresses with placeholder wallets, hashes, signatures, and IDs. ## OpenAPI ````yaml api-v1.openapi.json GET /v1/circle-gateway/deposit-addresses/status openapi: 3.1.0 info: title: Eco API version: v1 description: >- Reference for the Eco API at https://api.eco.com/v1: quotes, chain and token discovery, gasless funding, intent status, and Circle Gateway fast deposits. Every operation requires an API key except the Circle Gateway operations, which are open. servers: - url: https://api.eco.com description: Eco API security: [] tags: - name: quotes - name: intents - name: status - name: discovery - name: circle-gateway paths: /v1/circle-gateway/deposit-addresses/status: get: tags: - circle-gateway summary: Track a gasless deposit job description: >- Returns the state of a deposit address (`address`) or a gasless funding job (`jobId`). One filter is required. Always `200`; an unknown address or job is reported with `status: "unknown"`. Job status covers the funding transaction; the deposit lookup covers the deposit itself. No API key is required: Circle Gateway operations are open so that any wallet or relay can create and fund a deposit address. A supplied key that is unknown, revoked, or not enabled for v1 is still rejected with `401 invalid-api-key`, so send no key rather than a wrong one. No requests-per-second quota is published. Handle `429` and honor `Retry-After` when present. Examples use real mainnet token and contract addresses with placeholder wallets, hashes, signatures, and IDs. operationId: gateway-status parameters: - name: x-api-key in: header required: false schema: type: string description: >- Optional. A key that is unknown, revoked, or not enabled for v1 is rejected with 401. - name: address in: query required: false schema: type: string description: The deposit address to track. example: '0x379BAB257e7Eb159538F01165B766A1BEaf2D954' - name: jobId in: query required: false schema: type: string description: >- The gasless funding job to track, as a bare UUID or a 24-character legacy job ID, without the `gasless:` prefix. example: 0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a - name: cursor in: query required: false schema: type: string minLength: 1 description: Opaque cursor from a previous `nextCursor`. - name: limit in: query required: false schema: default: 20 type: integer minimum: 1 maximum: 50 description: Page size, 1-50. Default 20. responses: '200': description: Success content: application/json: schema: type: object properties: results: type: array items: type: object properties: id: type: string type: type: string enum: - intent - quote - gasless - deposit-address status: type: string updatedAt: type: - integer - 'null' intentHashes: type: array items: type: string txHash: type: - string - 'null' subStatuses: type: array items: type: object properties: chainId: type: integer quoteIds: type: array items: type: string txHash: type: - string - 'null' intentHashes: type: array items: type: string state: type: string enum: - pending - submitted - published - failed required: - chainId - quoteIds - txHash - intentHashes - state sourceTx: type: object properties: chainId: type: integer txHash: type: string token: type: string amount: type: string required: - chainId - txHash - token - amount destinationTx: type: object properties: chainId: type: integer txHash: type: string token: type: string amount: type: string required: - chainId - txHash - token - amount steps: type: array items: type: object properties: type: type: string enum: - SWAP - BRIDGE intentHash: type: string status: type: string from: type: object properties: token: type: string amount: type: string chainId: type: integer required: - token - amount - chainId to: type: object properties: token: type: string amount: type: string chainId: type: integer required: - token - amount - chainId transactions: type: object properties: created: type: object properties: chainId: type: integer txHash: type: string required: - chainId - txHash fulfilled: type: object properties: chainId: type: integer txHash: type: string required: - chainId - txHash refunded: type: object properties: chainId: type: integer txHash: type: string required: - chainId - txHash required: - type - intentHash - status - from - to - transactions required: - id - type - status - updatedAt nextCursor: type: - string - 'null' required: - results - nextCursor examples: job-completed: summary: A gasless funding job that landed on chain value: results: - id: gasless:0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a type: gasless status: published updatedAt: 1789522704 intentHashes: - >- 0x3f1886e7c3a4cab62b4a0661e393600f0917d5a514652e96623b0f17ce0d3749 subStatuses: - chainId: 8453 quoteIds: [] txHash: >- 0x3ef97346fd076aadb54c851f33ba9234feb34d27442b9bb0abc7a0d75827af13 intentHashes: - >- 0x3f1886e7c3a4cab62b4a0661e393600f0917d5a514652e96623b0f17ce0d3749 state: published nextCursor: null address-unknown: summary: 'Live: a deposit address the service has not seen (still 200)' value: results: - id: >- deposit-address:0x379BAB257e7Eb159538F01165B766A1BEaf2D954 type: deposit-address status: unknown updatedAt: null nextCursor: null job-unknown: summary: 'Live: a job ID the service has not seen (still 200)' value: results: - id: gasless:0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a type: gasless status: unknown updatedAt: null nextCursor: null '400': description: Request failed validation content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: type: https://api.eco.com/v1/errors/missing-parameter title: A required parameter is missing status: 400 code: missing-parameter detail: >- at least one filter required (address, jobId); paging controls alone are not a filter requestId: 180e4b3e4bfeff1dec42814b33e66dba '401': description: >- The supplied x-api-key is unknown, revoked, or not enabled for the v1 API. Returned for every v1 endpoint by the gateway, with Content-Type application/json. content: application/json: schema: $ref: '#/components/schemas/Problem' example: type: https://api.eco.com/v1/errors/invalid-api-key title: API key is missing, unknown, or revoked status: 401 code: invalid-api-key requestId: 98e4c42f-9c70-4539-843e-8d31803001e6 '403': description: Access denied for the supplied key. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: type: https://api.eco.com/v1/errors/permission-denied title: The caller may not perform this operation status: 403 code: permission-denied requestId: a9a151aa45c9dbf44c78513905f6606a '429': description: Rate limit exceeded content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: type: https://api.eco.com/v1/errors/rate-limit-exceeded title: Rate limit exceeded status: 429 code: rate-limit-exceeded requestId: 1eac3d6cc2aafa524b0c47a039576f8c '500': description: Internal error content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: type: https://api.eco.com/v1/errors/internal-error title: Internal error status: 500 code: internal-error requestId: 02dabcf0f4e3def9a6091526d3d21022 default: description: Error (RFC 9457 problem+json; see x-error-catalog) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' security: [] components: schemas: Problem: type: object properties: type: type: string format: uri title: type: string minLength: 1 status: type: integer minimum: 400 maximum: 599 code: type: string description: >- Stable, machine-readable error code from the catalog. Branch on this and `status`, not on `title` or `detail`. detail: type: string instance: type: string legacyCode: type: string description: >- The pre-v1 numeric error code this problem maps to, for integrations migrating from the older services. solverErrors: type: array items: type: object properties: solver: type: string description: >- Address on the relevant chain: `0x…` hex for EVM chains, base58 for Solana, `T…` base58 for Tron. solverName: type: string minLength: 1 code: type: string minLength: 1 message: type: string required: - solver - message errors: type: array items: type: object properties: field: type: string minLength: 1 detail: type: string minLength: 1 required: - field - detail description: Field-level validation failures. requestId: type: string description: >- Correlation ID for support. Present on router-served errors; deposit-address-served errors carry a short numeric value. required: - type - title - status - code ````