Skip to main content
GET
/
v1
/
execute
/
deposit
/
status
Check Near Intents deposit/swap status
curl --request GET \
  --url https://api.hypermid.io/v1/execute/deposit/status \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "depositId": "dep_abc123def456",
    "status": "DONE",
    "subStatus": "COMPLETED",
    "depositAddress": "0xDepositAddress",
    "depositAmount": "1000000000000000000",
    "depositTxHash": "0xDepositTxHash",
    "depositChainId": 1,
    "destinationAddress": "rRecipientXRPAddress",
    "destinationAmount": "3240000000",
    "destinationTxHash": "txDestinationHash",
    "destinationChainId": 900000004,
    "createdAt": 1711234576,
    "updatedAt": 1711234666
  },
  "error": null,
  "meta": {
    "requestId": "o5d6e7f8-a9b0-1234-8901-345678901234",
    "timestamp": 1711234670,
    "rateLimit": {
      "limit": 2000,
      "remaining": 1985,
      "reset": 1711234727
    }
  }
}
Returns the current status of a manual deposit and its associated swap. Use this endpoint for deposit-based swap routes instead of /v1/status.
​
depositId
string
required
The deposit ID returned from the /v1/execute endpoint.
{
  "data": {
    "depositId": "dep_abc123def456",
    "status": "DONE",
    "subStatus": "COMPLETED",
    "depositAddress": "0xDepositAddress",
    "depositAmount": "1000000000000000000",
    "depositTxHash": "0xDepositTxHash",
    "depositChainId": 1,
    "destinationAddress": "rRecipientXRPAddress",
    "destinationAmount": "3240000000",
    "destinationTxHash": "txDestinationHash",
    "destinationChainId": 900000004,
    "createdAt": 1711234576,
    "updatedAt": 1711234666
  },
  "error": null,
  "meta": {
    "requestId": "o5d6e7f8-a9b0-1234-8901-345678901234",
    "timestamp": 1711234670,
    "rateLimit": {
      "limit": 2000,
      "remaining": 1985,
      "reset": 1711234727
    }
  }
}

​
Status Values

StatusDescription
PENDINGWaiting for the user’s deposit
DEPOSIT_RECEIVEDDeposit confirmed, swap in progress
DONESwap completed successfully
FAILEDSwap failed
EXPIREDDeposit address expired before funds were received

​
Sub-Status Values

Sub-StatusDescription
WAITING_FOR_DEPOSITWaiting for the user to send funds
CONFIRMING_DEPOSITDeposit detected, waiting for confirmations
PROCESSING_SWAPSwap is being executed
COMPLETEDSwap finished successfully
DEPOSIT_EXPIREDDeposit window has expired
const status = await client.getDepositStatus({
  depositId: "dep_abc123def456",
});

console.log("Status:", status.data.status);
console.log("Sub-status:", status.data.subStatus);

if (status.data.status === "DONE") {
  console.log("Destination tx:", status.data.destinationTxHash);
  console.log("Amount received:", status.data.destinationAmount);
}

Authorizations

​
X-API-Key
string
header
required

Partner API key. Optional for public endpoints, required for /v1/partner/*.

Query Parameters

​
depositAddress
string
required

The deposit address to check

​
depositMemo
string

Deposit memo (if applicable)

Response

Deposit/swap status

​
data
object
required

Response payload (null on error)

​
error
object
required
​
meta
object
required