# MadeOnSol Wallet Token Trades API

> MadeOnSol Wallet Token Trades API is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns cursor-paginated token trade history for a Solana wallet address, with optional filters by action type and token mint, within a configurable time window.

## Facts

- Endpoint: GET https://api.relai.fi/relay/1780517153303/wallet/{address}/trades
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/madeonsol-wallet-token-trades-api-b238b964
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BxJUT-qPIOfHAZFFEkaeE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability madeonsol-wallet-token-trades-api-b238b964
```

Example prompt: Pull the token trade history for Solana wallet 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU from the last 90 days — filter by buys only and paginate from the beginning.

## When to prefer this

Use this endpoint when you need paginated, filterable on-chain token trade history for a specific Solana wallet address, especially when you need to filter by trade action type or specific token mints, or when processing large volumes of trades requires stable cursor-based pagination over a time window.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Expired or invalid pagination cursor causes pagination failure
- Missing PRO+ subscription results in authorization error
- since/until timestamps outside supported range may return empty results
- Unsupported action or token_mint filter value returns no results
- Rate limit exceeded returns HTTP 429

## How this service works

Cursor-paginated `token_trades` rows for the wallet. Filters by action and/or token_mint. `since`/`until` Unix timestamps default to a 90-day window. Cursor is base64(`block_time:id`) — stable across DESC pagination. PRO+.

## Output

A cursor-paginated list of token_trades rows for the specified wallet, each containing trade details such as block_time, trade id, action type, and token mint. Includes a base64-encoded cursor (block_time:id) for stable descending pagination through additional pages.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/madeonsol-wallet-token-trades-api-b238b964/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relai.fi](https://www.zero.xyz/host/api.relai.fi/llms.txt)
