AcrossAcross Developer Documentation
IntroductionGuidesAI AgentsToolsAPI ReferenceChains & Contracts

Get all deposits for a given depositor

Returns all deposits for a given depositor. 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. Request your key at https://t.me/acrosstg.

In: header

Query Parameters

limit?integer

Maximum number of deposits to return in a single request; used for pagination.

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.

address?string

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

Response Body

application/json

application/json

application/json

curl -X GET "https://app.across.to/api/deposits?limit=50&skip=100&depositor=0x89f423567c2648BB828c3997f60c47b54f57Fa6e&address=0x89f423567c2648BB828c3997f60c47b54f57Fa6e"
[
  {
    "id": 14503095,
    "relayHash": "0x89cb192c96170615b7e1a0fb20fb64b7c04f6641b301e2735287533e1dbb22ac",
    "depositId": "4333561",
    "originChainId": 8453,
    "destinationChainId": 42161,
    "depositor": "0xA4d353BBc130cbeF1811f27ac70989F9d568CeAB",
    "recipient": "0xA4d353BBc130cbeF1811f27ac70989F9d568CeAB",
    "inputToken": "0x4200000000000000000000000000000000000006",
    "inputAmount": "1000000000000000",
    "outputToken": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
    "outputAmount": "995226997892889",
    "message": "0x",
    "messageHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "exclusiveRelayer": "0xCad97616f91872C02BA3553dB315Db4015cBE850",
    "exclusivityDeadline": "null",
    "fillDeadline": "2025-07-24T19:26:20.000Z",
    "quoteTimestamp": "2025-07-24T16:07:11.000Z",
    "depositBlockNumber": 33292078,
    "depositBlockTimestamp": "2025-07-24T16:11:43.000Z",
    "status": "filled",
    "depositRefundTxnRef": null,
    "swapTokenPriceUsd": null,
    "swapFeeUsd": null,
    "bridgeFeeUsd": "0.017884155707075979",
    "inputPriceUsd": "3746.9406687316323",
    "outputPriceUsd": "3746.9406687316323",
    "fillGasFee": "2532354948000",
    "fillGasFeeUsd": "0.009488583742324977",
    "fillGasTokenPriceUsd": "3746.9406687316323",
    "actionsSucceeded": null,
    "swapTransactionHash": null,
    "swapToken": null,
    "swapTokenAmount": null,
    "relayer": "0xCad97616f91872C02BA3553dB315Db4015cBE850",
    "fillBlockTimestamp": "2025-07-24T16:11:43.000Z",
    "depositTxnRef": "0x92ffc5d69d00e14e79254f68adab030dd38119996501a88cac0da76557703d11",
    "fillTxnRef": "0x7b98cebd7ee6e2f75fead81d73005cdf25149141c2045cb5f731b6d9c6b9c517",
    "speedups": []
  }
]
{
  "type": "AcrossApiError",
  "code": "INVALID_PARAM",
  "status": 400,
  "message": "Invalid parameter at path 'depositor'. Expected type 'union'",
  "param": "originToken"
}
{
  "type": "AcrossApiError",
  "code": "INTERNAL_SERVER_ERROR",
  "status": 500,
  "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 available routes for transfers GET

Returns available routes based on specified parameters.