---
title: "GET /balance/{wallet}/events"
method: GET
path: "/balance/{wallet}/events"
tags: ["Balances"]
---

# GET /balance/{wallet}/events

`GET /balance/{wallet}/events`

## Request

- Base URL: `https://api.relay.link`
- URL: `https://api.relay.link/balance/{wallet}/events`
- Auth: none declared

Balance movements for one wallet: fee sponsorship, fixed-rate settlement, fee credits, deposits and withdrawals. A wallet linked to your integrator returns its full ledger with running balances; any other wallet returns the events your integrator caused on it, plus deposits and settled withdrawals, which are public on-chain. For current balances rather than history, use /app-fees/:wallet/balances.

## Path parameters

- `wallet` string, required

## Query parameters

- `requestId` string
- `requestIds` string
- `type` string
- `chainId` number, nullable
- `currency` string, nullable
- `startTimestamp` number, nullable
- `endTimestamp` number, nullable
- `limit` number, nullable
- `continuation` string, nullable

## Headers

- `x-api-key` string

## Response `200`

Default Response

- object
  - `wallet` string
  - `events` object[]
    - `id` string: Event identifier. Also the pagination cursor value.
    - `type` 'fee-credit' | 'fee-sponsorship-payment' | 'fee-sponsorship-refund' | 'gasless-refund' | 'balance-withdraw' | 'balance-deposit' | 'gas-sponsorship-payment' | 'fixed-rate-credit' | 'fixed-rate-debit' | 'fixed-bps-pnl' | 'fast-fill-hold' | 'fast-fill-release' | 'admin-manual-adjustment'
    - `requestId` string, nullable: The request this event belongs to. Null for events that are not request-scoped, such as deposits and withdrawals.
    - `wallet` string
    - `delta` object: Signed change to the balance. Negative amounts are debits.
      - `currency` object
        - `chainId` number
        - `address` string
        - `symbol` string
        - `name` string
        - `decimals` number
        - `metadata` object
          - `logoURI` string
          - `verified` boolean
          - `isNative` boolean
      - `amount` string
      - `amountFormatted` string
      - `amountUsd` string
    - `balanceAfter` object, nullable: Balance after this event. Returned only for a wallet linked to your integrator, where the whole ledger is visible and the running balance reconciles.
      - `currency` object
        - `chainId` number
        - `address` string
        - `symbol` string
        - `name` string
        - `decimals` number
        - `metadata` object
          - `logoURI` string
          - `verified` boolean
          - `isNative` boolean
      - `amount` string
      - `amountFormatted` string
      - `amountUsd` string
    - `details` object, nullable: Type-specific context. Present only where the event carries it; absent on rows written before the field existed.
      - `claimId` string, nullable: Withdrawal identifier. Present on `balance-withdraw` events only.
      - `fixedRate` string, nullable: The fixed rate the request was quoted at, e.g. `1:1`.
      - `currencyIn` object, nullable
        - `chainId` number
        - `address` string
      - `currencyOut` object, nullable
        - `chainId` number
        - `address` string
      - `currencyOutAmount` string, nullable
      - `marketAmountOut` string, nullable: What the output would have been at market. The settled delta is the difference between this and the amount delivered at the fixed rate.
      - `requestIds` string[], nullable: Requests covered by an event that spans more than one, such as a fast-fill write-off.
    - `createdAt` string
  - `continuation` string, nullable

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response

## Changes

- **2026-10-07** `4d3b915d1844`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/relay/apis/cross-chain-solver/changes/balance/:wallet/events/get.md)

---

[API](https://skmtc.dev/relay/apis/cross-chain-solver.md) · [All operations](https://skmtc.dev/relay/apis/cross-chain-solver/llms.txt) · [OpenAPI document](https://skmtc.dev/relay/apis/cross-chain-solver/revisions/85900d75d524?raw)