# Vybe Solana Token Trader Activity API

> Vybe Solana Token Trader Activity API is a paid API for AI agents from x402-api.vybenetwork.xyz, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-28).

Returns a paginated summary of trader activity (buy/sell volumes, counts) for a specific Solana token over a configurable time window

## Facts

- Endpoint: POST https://x402-api.vybenetwork.xyz/v4/tokens/%7BmintAddress%7D/trader-activity?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vybe-solana-token-trader-activity-api-a9329559
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9t7L5Z8IRlQ3bQvN2EG7h

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 vybe-solana-token-trader-activity-api-a9329559 -d '<json body>'
```

Example prompt: Show me the top 50 traders for the Solana token with mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v over the last 7 days, sorted by buy volume descending, and only include wallets with more than 5 buys.

## When to prefer this

Use this endpoint when you need to identify and rank individual wallet-level trading behavior for a specific Solana token — particularly for whale hunting, bot detection, or top trader leaderboards. Prefer this over general market endpoints when the unit of analysis is the trader wallet, not the token price or OHLCV data.

## Known failure modes

- Invalid or non-existent mint address returns empty results or 404
- Payment not included or insufficient USDC causes 402 Payment Required
- Invalid sort field name returns 400 bad request
- Using both sortByAsc and sortByDesc simultaneously returns 400
- Resolution value outside allowed enum ('1d','7d','30d') returns 400
- Page number beyond available data returns empty result set

## How this service works

Read access to Solana on-chain data — tokens, wallets, markets, prices, trades, transfers. No API key, no signup. Pay in USDC per request with the x402 protocol; the per-route price is declared in `x-payment-info`. WebSocket streaming uses prepaid credits.

## Output

A paginated list of trader activity summaries for the specified token mint, each record containing the trader wallet address plus aggregated buy volume (USD), sell volume (USD), buy count, and sell count over the requested time window. Results respect applied filters and sort order.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "mintAddress"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "description": "Page number to return (zero-indexed). Defaults to 0."
  },
  "limit": {
   "type": "integer",
   "description": "Maximum number of traders to return. Defaults to 1000."
  },
  "sortByAsc": {
   "type": "string",
   "description": "Sort ascending by 'buyVolumeUsd', 'sellVolumeUsd', 'buyCount', 'sellCount', or 'traderAddress'. If omitted, no sorting is applied. Only one of `sortByAsc` or `sortByDesc` can be used."
  },
  "buyCountGt": {
   "type": "integer",
   "description": "Only include traders with more than this many buy trades (exclusive). For example, `buyCountGt=5` returns traders with 6+ buys. If omitted, no minimum buy count filter is applied."
  },
  "resolution": {
   "type": "string",
   "description": "Time window for the activity summary. Possible values: '1d' (last day), '7d' (last 7 days), '30d' (last 30 days). Defaults to '1d'."
  },
  "sortByDesc": {
   "type": "string",
   "description": "Sort descending by 'buyVolumeUsd', 'sellVolumeUsd', 'buyCount', 'sellCount', or 'traderAddress'. If omitted, no sorting is applied. Only one of `sortByAsc` or `sortByDesc` can be used."
  },
  "buyVolumeGt": {
   "type": "string",
   "description": "Only include traders with buy volume greater than this value (exclusive, in token amount). If omitted, no minimum buy volume filter is applied."
  },
  "mintAddress": {
   "type": "string",
   "description": "The mint address of the token."
  },
  "sellCountGt": {
   "type": "integer",
   "description": "Only include traders with more than this many sell trades (exclusive). If omitted, no minimum sell count filter is applied."
  },
  "sellVolumeGt": {
   "type": "string",
   "description": "Only include traders with sell volume greater than this value (exclusive, in token amount). If omitted, no minimum sell volume filter is applied."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "$ref": "#/components/schemas/TradesTokenActivitySummaryResponse"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vybe-solana-token-trader-activity-api-a9329559/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-api.vybenetwork.xyz](https://www.zero.xyz/host/x402-api.vybenetwork.xyz/llms.txt)