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>",
    "chainId": 123,
    "kind": "mint",
    "product": "UTY",
    "vault": "<string>",
    "direction": {
      "from": "USDC",
      "to": "USDC"
    },
    "amount": {
      "value": "<string>",
      "token": "USDC",
      "address": "<string>",
      "decimals": 123
    },
    "status": "completed",
    "hash": "<string>",
    "blockNumber": 123,
    "timestamp": 123,
    "requestId": 123,
    "requestedAt": 123,
    "cooldownEndsAt": 123,
    "claimedAt": 123,
    "claimedHash": "<string>",
    "received": {
      "value": "<string>",
      "token": "USDC",
      "address": "<string>",
      "decimals": 123
    },
    "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:<chainId>:<vault>:<requestId>:<origin> (origin is hub or composer). UTY instant withdrawal rows reuse the mint/deposit format.

​
chainId
number
required

Chain id this row appears on. Matches the chainId query parameter.

​
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
​
amount
object
required
​
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}$
​
received
object

Pair amount on the output side. Populated on mint, UTY instant withdrawal, and claimed yUTY withdrawal rows. Absent on yUTY deposit rows and on cooldown/claimable withdrawal rows.

​
hubTx
string

Hub-side (Base) tx hash. Populated when chainId is a spoke (43114, 747474) and the row originated cross-chain.

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.