GET /api/v1/bridge/deposits

List bridge deposits

List bridge deposits.

operationId: listBridgeDeposits

Declared server differs from the callable one. This path declares its own servers base of https://exchange.nexus.xyz, without the /api/exchange mount the document default carries. Measured 2026-09-02, the override is not routed — https://exchange.nexus.xyz/api/v1/bridge/deposits returns 404 while the gateway form in the sample below is routed. A client generated from this contract will aim at the override; pin the gateway base until the per-network hosts are live. See Networks.

Not reachable through CCXT. Nexus-specific asset bridging. CCXT's deposit/withdraw methods model a venue's own custody, not a cross-chain bridge, and mapping them would misdescribe both.

Authentication: hmacAuth.

List the authenticated account's cross-chain deposits, newest first. Read-only: the watcher creates and advances these records, and this endpoint only reads them.

There is no pre-arrival state. A deposit exists only once the watcher observes an on-chain transfer, so every record carries a tx_hash and log_index (its id is {tx_hash}:{log_index}) and a confirmation count. A fiat-funded payment still in provider checkout is not yet a deposit and does not appear here.

Optional filters narrow by chain, asset and status; an unrecognized filter value simply matches nothing. Deposits are USDC or USDX only in this cut.

The list returns at most the newest 100 deposits and is not yet paginated: there is no cursor or time-window parameter, so an account with more than 100 deposits can only reach older ones by narrowing chain, asset or status. A cursor may be added later; doing so is additive.

Parameters

Name	In	Type	Required	Default	Description
limit	query	integer	No	100	Maximum records to return, 1-100. Values above the maximum are clamped to it; a non-integer or zero value is a 400.
chain	query	string	No	—	Filter by source chain, e.g. ethereum.
asset	query	string — one of USDC | USDX	No	—	Filter by deposited asset.
status	query	string — one of detected | confirming | credited | failed | reverted	No	—	Filter by deposit status.

Responses

Status	Body	Meaning
200	array of BridgeDeposit	Bridge deposits, newest first.
400	— (no schema declared)	—
401	— (no schema declared)	—
429	— (no schema declared)	—

Example

cURL

curl -X GET 'https://exchange.nexus.xyz/api/exchange/api/v1/bridge/deposits' \
  -H 'X-API-Key: nx_7f3a1b...' \
  -H 'X-Timestamp: 1776033911836' \
  -H 'X-Signature: <hmac-sha256>'

Python

import requests

headers = {
    "X-API-Key": "nx_7f3a1b...",
    "X-Timestamp": "1776033911836",
    "X-Signature": "<hmac-sha256>"
}

response = requests.get("https://exchange.nexus.xyz/api/exchange/api/v1/bridge/deposits", headers=headers)
response.raise_for_status()
print(response.json())

TypeScript

const response = await fetch("https://exchange.nexus.xyz/api/exchange/api/v1/bridge/deposits", {
  method: "GET",
  headers: {
    "X-API-Key": "nx_7f3a1b...",
    "X-Timestamp": "1776033911836",
    "X-Signature": "<hmac-sha256>"
  },
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
console.log(await response.json());

X-Signature is a placeholder: it is derived from this specific request. See Authentication for the canonical string and the HMAC rule.

---

_{Generated from eng/apps/exchange/api/openapi.json (spec 0.9.36). Do not edit by hand — regenerate with python3 product/docs/tools/api-reference/generate.py. Hand-authored context lives in the Guides pages.}