Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions features/deposit-addresses.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -960,6 +960,7 @@ curl -X GET "https://api.relay.link/requests/v2?depositAddress=<DEPOSIT_ADDRESS>
"address": "0xb353e49aa47514fb579d6ba6594c768379a96515",
"depositAddressType": "open",
"depositor": "0xb353e49aa47514fb579d6ba6594c768379a96515",
"depositTxHash": "0x41ce037184d661c35f102c961c88f587d137c611bf928389a562ff139ad51d4b",
},
"data": {
"slippageTolerance": "50",
Expand Down
1 change: 1 addition & 0 deletions references/api/api_guides/webhooks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ Relay Webhooks specifically stream transaction statuses for both cross and same-
"address": "0x..",
"depositAddressType": "open", // open / strict
"depositor": "0x..", //nullable
"depositTxHash": "0x..", //nullable — origin-chain tx hash of the depositor's transfer into the deposit address
}, //nullable
"requestId": "0x...",
"details": null,
Expand Down
4 changes: 4 additions & 0 deletions references/api/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@ title: "API Changelog"
description: "Record of breaking changes, deprecations, and notable additions to the Relay API"
---

## 2026-05-27 — `depositAddress` payloads add `depositTxHash`

**Added** — `GET /requests/v2` and the `request.status.updated` webhook/websocket event: the `depositAddress` object now includes `depositTxHash`, the origin-chain transaction hash of the depositor's transfer into the deposit address. This is distinct from `inTxHashes`, which tracks the sweep from the deposit address to the Relay depository. The field is `null` until the depositor's transfer is observed, and is omitted on non-deposit-address requests (where `depositAddress` itself is `null`).

## 2026-05-26 — Webhook payload adds `details`, `failReason`, `refundFailReason`

**Added** — `request.status.updated` webhook: the `data` object now includes `details`, `failReason`, and `refundFailReason`, matching the corresponding fields on [`GET /intents/status/v3`](/references/api/get-intents-status-v3). `failReason` returns `"N/A"` on non-failure statuses and the recorded reason (or `"UNKNOWN"`) on `failure`/`fallback`/`refund` statuses. `refundFailReason` defaults to `"N/A"` when no refund-leg failure is recorded. `details` is `null` when no additional context is available.
Expand Down
Loading