---
title: "One wallet's swaps through Chord's router"
method: GET
path: "/agent/router/wallet/{address}"
tags: ["Agents and status"]
---

# One wallet's swaps through Chord's router

`GET /agent/router/wallet/{address}`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/agent/router/wallet/{address}`
- Auth: none declared

What one address swapped through Chord's router contract in the last `days` × 24 h (rolling), read from the router's own `Swap` events: count and USD volume, in total and per chain. A swap with a dollar-stable leg is worth that leg; one with the chain's own coin (native or wrapped) on a leg is worth that amount at CoinGecko's price now; anything else is `unpriced` and counts for $0. MoltNode (moltnode.ag/quest) sizes RPC keys from `volumeUsd`. Public: router events are public chain data. Cached 60 s.

## Path parameters

- `address` string, required: EVM address, hex, case-insensitive.

## Query parameters

- `days` integer

## Response `200`

- object
  - `wallet` string: EVM address, hex, case-insensitive.
  - `days` integer
  - `since` integer: Unix seconds: the start of the window.
  - `swaps` integer: Swaps through the router in the window.
  - `volumeUsd` number: USD of the priced swaps.
  - `pricedBy` object
    - `stable` integer: Valued by a dollar-stable leg.
    - `coin` integer: Valued by the chain coin's leg at today's price.
  - `unpriced` integer: Swaps with neither leg: counted in `swaps`, worth $0 here.
  - `lastSwapAt` integer, nullable: Unix seconds of the latest swap.
  - `byChain` object[]: Largest volume first.
    - `chain` integer
    - `key` string
    - `swaps` integer
    - `volumeUsd` number

## Other responses

- `400`: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- `429`: Over the per-minute limit (`RATE_LIMIT_EXCEEDED`). Read `X-RateLimit-Reset` and back off.
- `503`: The lane behind this endpoint is not ready or not enabled here (`NOT_READY`, `CHAIN_NOT_ENABLED`, `NOT_ENABLED`, `*_UNAVAILABLE`). Retry later; do not treat it as an empty answer.

---

[API](https://skmtc.dev/getchord/apis/chord-api.md) · [All operations](https://skmtc.dev/getchord/apis/chord-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getchord/apis/chord-api/revisions/d3bc4640fea0?raw)