Track the lifecycle of a deposit

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.

GET
/deposit/status

Authorization

bearerAuth
AuthorizationBearer <token>

API key for authentication. Request your key at https://t.me/acrosstg.

In: header

Query Parameters

originChainId?integer

Chain Id where the deposit originated from. This must be used in conjunction with depositId. depositTxHash is not required when using this parameter.

Range1 <= value
Value in1 | 10 | 137 | 324 | 8453 | 42161 | 59144 | 84532 | 421614 | 11155420 | 11155111
depositId?integer

The deposit id that is emitted from the FundsDeposited event. This must be used in conjunction with originChainId. depositTxnRef is not required when using this parameter.

Range0 <= value
depositTxnRef*string

The deposit transaction hash that is emitted from the FundsDeposited event. If you are using this, you donot need the other parameters (i.e. originChainId and depositId).

Response Body

application/json

application/json

application/json

curl -X GET "https://app.across.to/api/deposit/status?originChainId=137&depositId=1349975&depositTxnRef=0x56a86610aad2a653161c9dd4b4972f948198fd02ae9589cfac1d57bd86a156c1"
{
  "status": "filled",
  "originChainId": 8453,
  "depositId": "4406025",
  "depositTxnRef": "0x0e44727151684ef4cfe7744aad88007cf55b155a64f5f9047fb9d2fa53780967",
  "fillTxnRef": "0x0e7b85f1c49c4c89f3b381f12a24d6838be16a41021ab16645bae9dcd1278238",
  "destinationChainId": 137,
  "depositRefundTxnRef": null,
  "actionsSucceeded": "null,",
  "pagination": {
    "currentIndex": 0,
    "maxIndex": 0
  }
}
{
  "type": "AcrossApiError",
  "code": "INVALID_PARAM",
  "status": 400,
  "message": "Invalid parameter at path 'depositId'. Expected type 'union'",
  "param": "originToken"
}
{
  "type": "AcrossApiError",
  "code": "INTERNAL_SERVER_ERROR",
  "status": 500,
  "message": "Internal server error"
}