---
title: "Owner's shadow swap history"
method: GET
path: "/v1/shadow/history/{wallet}"
tags: ["shadow"]
---

# Owner's shadow swap history

`GET /v1/shadow/history/{wallet}`

## Request

- Base URL: `https://swap-backend.stage.defi.ovh.gala.com`
- URL: `https://swap-backend.stage.defi.ovh.gala.com/v1/shadow/history/{wallet}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gala/apis/gala-defi-backend-api/docs/v1/shadow/history/:wallet/get.ts> (a function with typed inputs; its response is checked against the schema)

Owner-scoped list of the wallet's shadow swaps (isShadow: true), paged via page (0-based) + size. Requires a wallet-bound Bearer session token (from /challenge + /session); the non-prod ?__seed path returns synthetic rows without auth for FE development.

## Path parameters

- `wallet` string, required

## Query parameters

- `page` number
- `size` number
- `__seed` number

## Headers

- `authorization` string, required

## Response `200`

- ShadowHistoryResponseDto
  - `status` 'success', required
  - `data` ShadowHistoryDataResponseDto, required
    - `items` ShadowHistoryRowResponseDto[], required
      - `id` string, required
      - `txHash` string, nullable, required
      - `status` 'pending' | 'confirmed' | 'failed' | 'unconfirmed' | 'unverifiable', required
      - `blockNumber` number, nullable, required
      - `timestamp` string, date-time, required
      - `soldTokenAssetId` string, required
      - `receivedTokenAssetId` string, required
      - `soldAmount` number, nullable, required
      - `receivedAmount` number, nullable, required
      - `usdVolume` number, nullable, required
      - `isShadow` true, required
      - `poolRecipient` string
    - `count` number, required

## Other responses

- `400`
- `401`
- `default`: An error response using the shared backend error envelope.

---

[API](https://skmtc.dev/gala/apis/gala-defi-backend-api.md) - [All operations](https://skmtc.dev/gala/apis/gala-defi-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gala/apis/gala-defi-backend-api/revisions/84f8184e2828?raw)