# Deposits

## Get all deposits

> Returns all USDCx deposits from Ethereum to Stacks, aggregating data from 3 sources:\
> \- \*\*ETH Events\*\*: DepositedToRemote events from the xReserve contract\
> \- \*\*Circle Attestations\*\*: Signed attestations from Circle's API (after ETH finality)\
> \- \*\*STX Mints\*\*: Print events from the relay transaction on Stacks\
> \
> Each deposit has a status:\
> \- \`pending\`: Only the ETH event exists (waiting for Circle attestation)\
> \- \`attested\`: ETH event + Circle attestation (waiting to be relayed)\
> \- \`relayed\`: All 3 sources present (deposit completed)\
> \
> Deposits are matched by nonce and sorted chronologically (newest first).

```json
{"openapi":"3.0.3","info":{"title":"USDCx API","version":"1.0.0"},"tags":[{"name":"Deposits"}],"servers":[{"url":"https://api.usdc-on-stacks.com","description":"USDCx API Server"}],"paths":{"/{networkStr}/deposits":{"get":{"summary":"Get all deposits","description":"Returns all USDCx deposits from Ethereum to Stacks, aggregating data from 3 sources:\n- **ETH Events**: DepositedToRemote events from the xReserve contract\n- **Circle Attestations**: Signed attestations from Circle's API (after ETH finality)\n- **STX Mints**: Print events from the relay transaction on Stacks\n\nEach deposit has a status:\n- `pending`: Only the ETH event exists (waiting for Circle attestation)\n- `attested`: ETH event + Circle attestation (waiting to be relayed)\n- `relayed`: All 3 sources present (deposit completed)\n\nDeposits are matched by nonce and sorted chronologically (newest first).","tags":["Deposits"],"parameters":[{"name":"networkStr","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deposits":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"amount":{"type":"string"},"amountFormatted":{"type":"string"},"circleAttestation":{"type":"object","properties":{"attestation":{"type":"string"},"decodedAmount":{"type":"string"},"decodedRemoteRecipient":{"type":"string"},"messageHash":{"type":"string"},"payload":{"type":"string"}},"required":["attestation","decodedAmount","decodedRemoteRecipient","messageHash","payload"]},"ethEvent":{"type":"object","properties":{"blockNumber":{"type":"string"},"localDepositor":{"type":"string"},"localToken":{"type":"string"},"logIndex":{"type":"number"},"maxFee":{"type":"string"},"nonce":{"type":"string"},"remoteRecipient":{"type":"string"},"transactionHash":{"type":"string"},"value":{"type":"string"}},"required":["blockNumber","localDepositor","localToken","logIndex","maxFee","nonce","remoteRecipient","transactionHash","value"]},"ethExplorerLink":{"type":"string"},"ethTxid":{"type":"string","pattern":"^0x[0-9a-fA-F]*$"},"nonce":{"type":"string"},"status":{"const":"attested"},"stxRecipient":{"type":"string"}},"required":["amount","amountFormatted","circleAttestation","ethEvent","ethExplorerLink","ethTxid","nonce","status","stxRecipient"]},{"type":"object","properties":{"amount":{"type":"string"},"amountFormatted":{"type":"string"},"circleAttestation":{"type":"object","properties":{"attestation":{"type":"string"},"decodedAmount":{"type":"string"},"decodedRemoteRecipient":{"type":"string"},"messageHash":{"type":"string"},"payload":{"type":"string"}},"required":["attestation","decodedAmount","decodedRemoteRecipient","messageHash","payload"]},"ethEvent":{"type":"object","properties":{"blockNumber":{"type":"string"},"localDepositor":{"type":"string"},"localToken":{"type":"string"},"logIndex":{"type":"number"},"maxFee":{"type":"string"},"nonce":{"type":"string"},"remoteRecipient":{"type":"string"},"transactionHash":{"type":"string"},"value":{"type":"string"}},"required":["blockNumber","localDepositor","localToken","logIndex","maxFee","nonce","remoteRecipient","transactionHash","value"]},"ethExplorerLink":{"type":"string"},"ethTxid":{"type":"string","pattern":"^0x[0-9a-fA-F]*$"},"nonce":{"type":"string"},"status":{"const":"relayed"},"stxExplorerLink":{"type":"string"},"stxMint":{"type":"object","properties":{"blockHeight":{"type":"number"},"eventIndex":{"type":"number"},"feeAmount":{"type":"string"},"mintAmount":{"type":"string"},"recipient":{"type":"string"},"txId":{"type":"string"}},"required":["blockHeight","eventIndex","feeAmount","mintAmount","recipient","txId"]},"stxMintTxid":{"type":"string","pattern":"^0x[0-9a-fA-F]*$"},"stxRecipient":{"type":"string"}},"required":["amount","amountFormatted","circleAttestation","ethEvent","ethExplorerLink","ethTxid","nonce","status","stxExplorerLink","stxMint","stxMintTxid","stxRecipient"]},{"type":"object","properties":{"amount":{"type":"string"},"amountFormatted":{"type":"string"},"ethEvent":{"type":"object","properties":{"blockNumber":{"type":"string"},"localDepositor":{"type":"string"},"localToken":{"type":"string"},"logIndex":{"type":"number"},"maxFee":{"type":"string"},"nonce":{"type":"string"},"remoteRecipient":{"type":"string"},"transactionHash":{"type":"string"},"value":{"type":"string"}},"required":["blockNumber","localDepositor","localToken","logIndex","maxFee","nonce","remoteRecipient","transactionHash","value"]},"ethExplorerLink":{"type":"string"},"ethTxid":{"type":"string","pattern":"^0x[0-9a-fA-F]*$"},"nonce":{"type":"string"},"status":{"const":"pending"},"stxRecipient":{"type":"string"}},"required":["amount","amountFormatted","ethEvent","ethExplorerLink","ethTxid","nonce","status","stxRecipient"]}]}},"total":{"type":"number"}},"required":["deposits","total"]}}}}},"operationId":"getByNetworkStrDeposits"}}}}
```
