Skip to main content
GET
/
v1
/
transactions
/
{address}
Returns multi-chain transaction history for a given wallet address.
curl --request GET \
  --url https://api.yieldpoint.io/v1/transactions/{address}
[
  {
    "id": "<string>",
    "requestedOnChainId": 123,
    "claimedOnChainId": 123,
    "vault": "<string>",
    "direction": {},
    "sent": {
      "value": "<string>",
      "address": "<string>",
      "decimals": 123
    },
    "received": {
      "value": "<string>",
      "address": "<string>",
      "decimals": 123
    },
    "hash": "<string>",
    "blockNumber": 123,
    "timestamp": 123,
    "requestId": 123,
    "requestedAt": 123,
    "cooldownEndsAt": 123,
    "claimedAt": 123,
    "claimedHash": "<string>",
    "hubTx": "<string>",
    "hubTimestamp": 123,
    "hubBlockNumber": 123
  }
]

Path Parameters

​
address
string
required

0x-prefixed 40-character wallet address (any case).

Query Parameters

​
chainId
number
required

Supported: 8453 (Base), 43114 (Avalanche), 747474 (Katana)

Response

​
id
string
required

Stable composite key. Mint/deposit rows: <kind>:<chainId>:<vault>:<hash>:<eventId>. Withdrawal lifecycle rows: withdrawal:<vault>:<hubRequestId> (hub vault request id is the canonical identity for both hub-direct and composer-routed redemptions). UTY instant withdrawal rows reuse the mint/deposit format.

​
requestedOnChainId
number
required

Chain where this activity was initiated. For hub-direct redemptions and Base mints/deposits this is 8453. For composer-routed redemptions this is the spoke chain (43114 Avalanche or 747474 Katana) derived from the composer's RedeemRequested.dst_eid. Matches the chainId query parameter on the listed row.

​
claimedOnChainId
number | null
required

Chain where the claim landed. 8453 when the user redeemed directly on Base (receiver=user); the spoke chain when the composer bridged UTY back via OFT (receiver=composer, dst_eid → chainId). Null while the request is still in cooldown or claimable. For mint/deposit and UTY instant withdrawal rows this equals requestedOnChainId (atomic, no separate claim step).

​
kind
enum<string>
required

Row kind. mint = UTY vault deposit (USDC → UTY). deposit = yUTY vault deposit (UTY → yUTY). withdrawal = yUTY async redemption lifecycle or UTY instant redemption.

Available options:
mint,
deposit,
withdrawal
​
product
enum<string>
required
Available options:
UTY,
yUTY
​
vault
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
​
direction
object
required
​
sent
object
required

Input side of the swap — the token the user is giving / has given. For mint: USDC paid in. For deposit: UTY paid in. For withdrawal: shares burned (UTY for UTY-vault redemptions, yUTY for yUTY-vault redemptions). On UTY cooldown rows the value is null until the WithdrawalRequest struct is read on-chain by the API enrichment pass.

​
received
object
required

Output side of the swap — the token the user is receiving / has received. For mint: UTY shares minted. For deposit: yUTY shares minted. For withdrawal: asset paid out (USDC for UTY redemptions, UTY for yUTY redemptions). On in-flight withdrawal rows the value reflects the asset snapshot at request time; on claimed rows it reflects the actual settled amount.

​
status
enum<string>
required

Lifecycle status. completed only on mint rows. locked only on deposit rows. cooldown → claimable → claimed is the yUTY withdrawal lifecycle; UTY instant withdrawals are born at claimed.

Available options:
completed,
locked,
cooldown,
claimable,
claimed
​
hash
string
required

Most-recent on-chain tx hash for this row. On cross-chain rows this is the spoke-side arrival; see hubTx for the hub-side leg.

Pattern: ^0x[a-fA-F0-9]{64}$
​
blockNumber
number
required
​
timestamp
number
required

Unix seconds of the most-recent event for this row. On withdrawal lifecycle rows this is the latest of (request, request_closed, claim) — not the original request time. See requestedAt for the request time.

​
requestId
number | null

Vault request id. Null on UTY instant withdrawals (no request was created). Absent on mint and deposit rows.

​
requestedAt
number

Unix seconds when the redemption request was created. Required on every withdrawal row, including UTY instant (where it equals claimedAt).

​
cooldownEndsAt
number | null

Unix seconds when the bonding period ends. Null on UTY instant withdrawals (no cooldown).

​
claimedAt
number | null

Unix seconds when the claim settled. Null while status is cooldown or claimable.

​
claimedHash
string | null

Tx hash of the settling Withdraw event. Null while status is cooldown or claimable.

Pattern: ^0x[a-fA-F0-9]{64}$
​
hubTx
string

Hub-side (Base) tx hash. Populated on cross-chain rows where requestedOnChainId or claimedOnChainId is a spoke (43114, 747474).

Pattern: ^0x[a-fA-F0-9]{64}$
​
hubTimestamp
number

Unix seconds of the hub-side event. Paired with hubTx on cross-chain rows.

​
hubBlockNumber
number

Hub-side block number. Paired with hubTx on cross-chain rows.