AcrossAcross Docs
IntroductionGuidesAI AgentsToolsAPI ReferenceChains & Contracts

Get all deposits matching the given filters

Returns all deposits matching the given filters, newest first (ordered by depositBlockTimestamp descending). Filters combine with AND. /deposits is the endpoint to use when a transaction might identify multiple transfers. This endpoint loads data queried by an indexing service that polls relevant events on a 10-second cadence. Users should therefore expect an average latency of 1 to 15 seconds after submitting a deposit to see the status changed in this endpoint. This delay comes from the time it takes for the internal indexing to include the deposit transaction.

GET
/deposits

Authorization

bearerAuth
AuthorizationBearer <token>

API key for authentication.

In: header

Query Parameters

limit?integer

Maximum number of deposits to return in a single request; used for pagination. Defaults to 50, maximum 1000.

Default50
Rangevalue <= 1000
skip?integer

Number of deposits to skip from the beginning of the result set; used for pagination.

Range0 <= value
depositor?string

Wallet address of the depositor; filters results to deposits made by this address. For deposit-address (PDA) flows this is the sender of the funding transaction, not the deposit address itself.

recipient?string

Wallet address of the recipient on the destination chain; filters results to deposits delivering to this address.

refundAddress?string

Filters to transfers whose refund was (or will be) sent to this address — the recipient of depositRefundTxnRef.

address?string

This parameter would help return transactions where the provided address is either the depositor or recipient.

originChainId?integer

Chain ID where the deposit originated — the chain where funds entered the system.

destinationChainId?integer

Chain ID where the fill is expected to complete.

status?string

Filter deposits by lifecycle status. The filter accepts the intents lifecycle values listed below; deposit-address-specific statuses (e.g. deposit-pending, auto-refund-pending) are returned in responses but are not filterable.

Value in"unfilled" | "filled" | "slowFillRequested" | "slowFilled" | "expired" | "refunded"
depositAddress?string

A persistent deposit address returned by POST /deposit-addresses. When present, the endpoint switches to a standalone mode that returns the transfers sent to this address, newest first, each enriched with the bridge deposit created for it once the sweep is indexed. All other filters except limit and skip are ignored in this mode. Cannot be combined with sweepTxnRef (400).

Each item's depositTxnRef carries the transaction hash of the inbound transfer (the transaction you sent to the deposit address), and additional status values are possible: a transfer that hasn't been swept yet reports deposit-pending, and transfers that enter the auto-refund lifecycle report auto-refund-pending, refunded, refund-failed, or manual-refund-required.

depositTxnRef?string

Exact funding transaction reference — the transaction where funds entered the system. For deposit-address (PDA) flows this is the transaction that funded the deposit address.

fillTxnRef?string

Exact final output/fill transaction reference; may return multiple transfers.

depositRefundTxnRef?string

Exact final user-facing refund transaction reference.

sweepTxnRef?string

Exact PDA sweep/execution transaction reference — the transaction that moved funds out of a persistent deposit address into the bridge. Like depositAddress, this switches the endpoint to a standalone mode: it returns the deposit-address transfers executed by this sweep transaction (one sweep can batch several), and all other filters except limit and skip are ignored. Cannot be combined with depositAddress (400).

txnRef?string

Matches any transaction reference on the transfer (depositTxnRef, sweepTxnRef, fillTxnRef, depositRefundTxnRef or actionsTargetTxnRef). Query-only — it is never returned and never changes the response fields.

Response Body

application/json

application/json

application/json

curl -X GET "https://across.to/api/deposits?limit=50&skip=0&depositor=0x4dB2fd4e004D16CC23606d03853b5D405F8EC2ff"
[
  {
    "depositAddress": null,
    "sweepTxnRef": null,
    "depositRefundAddress": null,
    "actionsTargetRecipient": null,
    "actionsTargetToken": null,
    "actionsTargetAmount": null,
    "actionsTargetTxnRef": null,
    "actionsTargetBlockTimestamp": null,
    "id": 12066491,
    "relayHash": "0xb79fafb0359e40770ca98e057d24155aa4f31f365b57b32f69afdc50559c25c8",
    "depositId": "2996407",
    "originChainId": 10,
    "destinationChainId": 137,
    "depositor": "0x8b94C64ff7d39CAaaAC24450eb665e4EDF6aF0e9",
    "recipient": "0x89f423567c2648BB828c3997f60c47b54f57Fa6e",
    "inputToken": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "inputAmount": "3000302",
    "outputToken": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
    "swapOutputToken": null,
    "swapOutputTokenAmount": null,
    "outputAmount": "2999136",
    "message": "0x",
    "messageHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "exclusiveRelayer": "0x0000000000000000000000000000000000000000",
    "exclusivityDeadline": null,
    "fillDeadline": "2025-05-05T05:23:16.000Z",
    "quoteTimestamp": "2025-05-05T01:19:35.000Z",
    "depositTxHash": "0x8a0e23bcdc4c5789b027e94f762e195321969bbecd480f0e5ccc1e821677c4c4",
    "depositBlockNumber": 135404717,
    "depositBlockTimestamp": "2025-05-05T01:23:31.000Z",
    "status": "filled",
    "depositRefundTxHash": null,
    "swapTokenPriceUsd": null,
    "swapFeeUsd": null,
    "bridgeFeeUsd": "0.00013356715219418",
    "inputPriceUsd": "0.9998998519590344",
    "outputPriceUsd": "1.000244056448324",
    "fillGasFee": "5598699903289746",
    "fillGasFeeUsd": "0.001338150429443897",
    "fillGasTokenPriceUsd": "0.2390109226353805",
    "actionsSucceeded": null,
    "actionsTargetChainId": null,
    "swapTransactionHash": null,
    "swapToken": null,
    "swapTokenAmount": null,
    "relayer": "0x07aE8551Be970cB1cCa11Dd7a11F47Ae82e70E67",
    "fillBlockNumber": 71122734,
    "fillBlockTimestamp": "2025-05-05T01:26:24.000Z",
    "fillTx": "0xd5320ce6837a0f37643284af60ee99fb41a9ee4907ac6fbc19ffe654555f81d3",
    "depositTxnRef": "0x8a0e23bcdc4c5789b027e94f762e195321969bbecd480f0e5ccc1e821677c4c4",
    "depositRefundTxnRef": null,
    "fillTxnRef": "0xd5320ce6837a0f37643284af60ee99fb41a9ee4907ac6fbc19ffe654555f81d3",
    "speedups": []
  }
]
{
  "error": "IncorrectQueryParamsException",
  "message": "Incorrect query params provided"
}
{
  "error": "UnknownError",
  "message": "Internal server error"
}

Track the lifecycle of a deposit GET

Returns the fill status of a deposit along with a corresponding fill transaction hash if filled. This endpoint loads data queried by an indexing service that polls relevant events on a 10-second cadence. Users should therefore expect an average latency of 1 to 15 seconds after submitting a deposit to see the status changed in this endpoint. This delay comes from the time it takes for the internal indexing to include the deposit transaction.

Retrieve suggested fee quote for a deposit. GET

Returns suggested fees based on `inputToken`, `outputToken`, `originChainId`, `destinationChainId`, and `amount`. Also includes transfer limits of the system and data used to compute the fees.