---
title: "Get affiliate swaps"
method: GET
path: "/v1/affiliate/swaps"
tags: ["Affiliate"]
---

# Get affiliate swaps

`GET /v1/affiliate/swaps`

Retrieve paginated swap history for an affiliate by partnerCode. Supports optional date range filtering.

## Query parameters

- `partnerCode` string, required
- `startDate` string, date-time
- `endDate` string, date-time
- `limit` integer
- `cursor` string

## Response `200`

Affiliate swaps

- AffiliateSwapsResponse
  - `swaps` AffiliateSwap[], required
    - `swapId` string, required
    - `status` string, required
    - `sellAsset` Asset, required
      - `assetId` string, required
      - `chainId` string, required
      - `name` string, required
      - `symbol` string, required
      - `precision` number, required
      - `color` string, required
      - `icon` string, required
      - `networkName` string
      - `networkColor` string
      - `networkIcon` string
      - `explorer` string, required
      - `explorerAddressLink` string, required
      - `explorerTxLink` string, required
      - `relatedAssetKey` string, nullable, required
    - `buyAsset` Asset, required
      - `assetId` string, required
      - `chainId` string, required
      - `name` string, required
      - `symbol` string, required
      - `precision` number, required
      - `color` string, required
      - `icon` string, required
      - `networkName` string
      - `networkColor` string
      - `networkIcon` string
      - `explorer` string, required
      - `explorerAddressLink` string, required
      - `explorerTxLink` string, required
      - `relatedAssetKey` string, nullable, required
    - `sellAmountCryptoPrecision` string, required
    - `sellAmountUsd` string, nullable, required
    - `buyAmountCryptoPrecision` string, nullable, required
    - `buyAmountUsd` string, nullable, required
    - `affiliateFeeAmountUsd` string, nullable, required
    - `affiliateBps` integer, required
    - `partnerBps` integer, nullable, required
    - `shapeshiftBps` integer, required
    - `swapperName` string, required
    - `sellTxHash` string, nullable, required
    - `buyTxHash` string, nullable, required
    - `isAffiliateVerified` boolean, nullable, required
    - `createdAt` string, required
  - `nextCursor` string, nullable, required

## Other responses

- `400` — Invalid query parameters
- `429` — Rate limit exceeded. Includes Retry-After header with seconds until reset.
- `500` — Internal server error
- `503` — Swap service unavailable
- `504` — Swap service timed out

---

[API](https://skmtc.net/shapeshift/apis/shapeshift-public-api.md) · [All operations](https://skmtc.net/shapeshift/apis/shapeshift-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shapeshift/shapeshift-public-api/revisions/6ffb6a8fd74a/schema)