---
title: WalletFinder - Historical On-Chain Trading Analytics
slug: historical-chain-trading-analytics
url: https://apyhub.com/walletfinderai/service/historical-chain-trading-analytics
provider: Juan Montenegro
categories: [Finance]
tags: [crypto-wallets, wallet-discovery, trader-ranking, onchain-analytics, solana, ethereum]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 5
atoms: 5-30
mcp: true
---

# WalletFinder - Historical On-Chain Trading Analytics

Discover crypto wallets, trades, and raw swap events on Ethereum, Base, and Solana. Get profit, risk, and performance metrics for wallet analysis.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/discoverWallets` | What it does Returns a filtered and sorted list of discovered wallets. You control the chain, timef… | 10 |
| GET | `https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/discoverTrades` | What it does Returns a list of discovered trades filtered and sorted by the query parameters you pr… | 10 |
| GET | `https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/swaps` | What it does Returns raw swap event records for the specified chain, sorted according to the reques… | 30 |
| GET | `https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/walletOverview` | What it does Returns wallet overview data for the requested wallet address and timeframe, with an o… | 8 |
| GET | `https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/walletOverviewStats` | What it does Retrieves overview statistics for a wallet over a requested timeframe. The response re… | 5 |

## Endpoint reference

### Discover wallets

`GET https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/discoverWallets` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | integer | no | Default: `1`. |
| `chain` | query | string | yes | One of: ethereum, base, solana. |
| `filter` | query | string | no |  |
| `sortBy` | query | string | yes | One of: walletAddress, tokens, totalProfit, potentialATHprofit, speed, alphaPerc, diamondTokens, gemPerc, winPerc, realAlphaPerc, scamPerc, averageXs, averageATHXs, lastBuy, lastInvestment, averageHO… |
| `sortOrder` | query | string | yes | One of: asc, desc. |
| `timeframe` | query | string | yes | One of: hour, day, week, month, month3, year. |
| `showScamWallets` | query | string | no | One of: true, false. Default: `false`. |
| `showRiskyWallets` | query | string | no | One of: true, false. Default: `false`. |

#### Quickstart

Get a sorted list of wallets for a chosen chain and timeframe.

```bash
curl -X GET "https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/discoverWallets?chain=ethereum&sortBy=totalProfit&sortOrder=desc&timeframe=day" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `wallets` array and a `totalRecords` integer. Each item in `wallets` is an object with wallet metrics such as `walletAddress`, `tokens`, `totalProfit`, `walletRiskStatus`, and related fields.

```json
{
  "wallets": [
    {
      "walletAddress": "0xabc123...",
      "tokens": 12,
      "totalProfit": 2450.5,
      "walletRiskStatus": "NORMAL"
    }
  ],
  "totalRecords": 1
}
```

### Discover trades

`GET https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/discoverTrades` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | integer | no | Default: `1`. |
| `chain` | query | string | yes | One of: ethereum, base, solana. |
| `filter` | query | string | no |  |
| `sortBy` | query | string | yes | One of: walletAddress, tokenAddress, tokenSymbol, tradeDate, block, firstBuy, maxATHProfit, ATHXs, investment, netProfit, netXs, riskPerc. |
| `sortOrder` | query | string | yes | One of: asc, desc. |
| `timeframe` | query | string | yes | One of: hour, day, week, month, month3, year. |
| `tokenSymbol` | query | string | no |  |
| `showScamWallets` | query | string | no | One of: true, false. Default: `false`. |
| `showRiskyWallets` | query | string | no | One of: true, false. Default: `false`. |
| `showWrappedTokens` | query | string | no | One of: true, false. Default: `false`. |
| `excludeStableCoins` | query | string | no | One of: true, false. Default: `true`. |

#### Quickstart

Fetch the first page of Ethereum trades for the last day, sorted by trade date.

```bash
curl -X GET "https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/discoverTrades?chain=ethereum&sortBy=tradeDate&sortOrder=desc&timeframe=day" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `trades` array and a `totalRecords` integer. Each item in `trades` is an object with trade details such as `walletAddress`, `tokenAddress`, `tokenSymbol`, `tradeDate`, and related metrics.

```json
{
  "trades": [
    {
      "walletAddress": "0x1234...abcd",
      "tokenAddress": "0xabcd...1234",
      "tokenSymbol": "USDC",
      "tradeDate": "2026-09-03 09:30:00",
      "investment": 1000,
      "netProfit": 250
    }
  ],
  "totalRecords": 1
}
```

### Raw swap events

`GET https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/swaps` · 30 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `chain` | query | string | yes | One of: ethereum, base, solana. |
| `filter` | query | string | no |  |
| `sortBy` | query | string | yes | One of: _price_native_usd, amount_native, amount_token, amount_quote, block_number, gas_price_native, gas_used, interacted_with_address, pool_address, price_token_usd_robust_tick_1, price_token_usd_t… |
| `sortOrder` | query | string | yes | One of: asc, desc. |

#### Quickstart

Fetch the latest raw swap events for a chain, sorted by the field you choose.

```bash
curl -X GET "https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/swaps?chain=ethereum&sortBy=timestamp&sortOrder=desc" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON array of event objects. Each object may include fields such as `side`, `timestamp`, `token_name`, `amount_token`, `amount_quote`, `block_number`, `pool_address`, `token_address`, `trader_address`, and `transaction_hash`.

```json
[
  {
    "side": "buy",
    "timestamp": 1710000000,
    "token_name": "Example Token",
    "amount_token": 100.5,
    "amount_quote": 2500.75,
    "block_number": 12345678,
    "pool_address": "0xabc123...",
    "token_address": "0xdef456...",
    "trader_address": "0x789abc...",
    "transaction_hash": "0xdeadbeef..."
  }
]
```

### Wallet overview

`GET https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/walletOverview` · 8 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `chain` | query | string | no | One of: ethereum, base, solana. |
| `timeframe` | query | string | yes | One of: hour, day, week, month, month3, year. |
| `walletAddress` | query | string | yes |  |

#### Quickstart

Fetch a wallet overview for a specific wallet address and timeframe.

```bash
curl -X GET "https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/walletOverview?walletAddress=0x8ba1f109551bD432803012645Ac136ddd64DBA72&timeframe=day" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` object and a `chains` array. The `data` object includes wallet overview metrics such as `chain`, `speed`, `tokens`, `gemPerc`, `lastBuy`, `winPerc`, `riskPerc`, `alphaPerc`, `averageXs`, `averageHODL`, `totalProfit`, `averageATHXs`, `diamondTokens`, `inv_prof_hist`, `realAlphaPerc`, `walletAddress`, `lastInvestment`, `walletRiskStatus`, and `potentialATHprofit`.

```json
{
  "data": {
    "chain": "ethereum",
    "speed": "fast",
    "tokens": 12,
    "walletAddress": "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
  },
  "chains": ["ethereum", "base", "solana"]
}
```

### Wallet overview stats

`GET https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/walletOverviewStats` · 5 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `chain` | query | string | no | One of: ethereum, base, solana. |
| `timeframe` | query | string | yes | One of: hour, day, week, month, month3, year. |
| `walletAddress` | query | string | yes |  |

#### Quickstart

Fetch wallet overview stats for a wallet on the selected chain and timeframe.

```bash
curl -X GET "https://api.eu.apyhub.com/walletfinderai/historical-chain-trading-analytics/walletOverviewStats?walletAddress=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&timeframe=month&chain=ethereum" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` object and a `chains` array. The `data` object includes wallet stats such as `chain`, `speed`, `tokens`, `gemPerc`, `lastBuy`, `winPerc`, `riskPerc`, `alphaPerc`, `averageXs`, `averageHODL`, `totalProfit`, `averageATHXs`, `diamondTokens`, `realAlphaPerc`, `walletAddress`, `lastInvestment`, `walletRiskStatus`, and `potentialATHprofit`; `chains` lists supported chain values.

```json
{
  "data": {
    "chain": "ethereum",
    "speed": "fast",
    "tokens": 12,
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
  },
  "chains": ["ethereum", "base", "solana"]
}
```

## About

## What it does
Wallet Finder helps you discover and inspect trading wallets, trades, and raw swap activity across Ethereum, Base, and Solana. Send a chain plus a timeframe, and get ranked wallet or trade results back with profit, win rate, risk, and other trading signals.

Use the Discover wallets endpoint to list wallets by metrics such as `tokens`, `totalProfit`, `potentialATHprofit`, `speed`, `alphaPerc`, `gemPerc`, `winPerc`, `realAlphaPerc`, `riskPerc`, `suspiciousTokenPerc`, or `walletRiskStatus`. You can filter results, choose ascending or descending sort order, and include or exclude scam and risky wallets. The response includes each wallet address plus the selected performance and risk fields, along with `totalRecords` for pagination.

Use the Discover trades endpoint when you want token-level activity instead of wallet summaries. It supports sorting by fields like `tradeDate`, `block`, `investment`, `netProfit`, `netXs`, `ATHXs`, and `riskPerc`, and can filter by `tokenSymbol`. Each result includes the trader wallet address, token address, token symbol, profit and investment values, risk status, alert counts, and the token image URL when available.

For deeper analysis, the Raw swap events endpoint returns low-level swap records sorted by block, timestamp, token, trader, or transaction hash. Each record includes swap side, amounts, price fields, pool and quote addresses, transaction hash, gas usage, and token metadata. Use Wallet overview or Wallet overview stats to fetch a single wallet’s metrics for a timeframe, including `inv_prof_hist` in the overview response and a compact stats payload in the stats endpoint.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/walletfinderai/service/historical-chain-trading-analytics