Skip to main content
GET
/
explorer
/
wallet
/
{addr}
Per-wallet activity
curl --request GET \
  --url https://api.leokit.dev/explorer/wallet/{addr}
{
  "data": {
    "address": "<string>",
    "summary": {
      "total_volume_usd": 123,
      "transaction_count": 123,
      "received_count": 123,
      "first_seen": "2023-11-07T05:31:56Z",
      "last_seen": "2023-11-07T05:31:56Z",
      "avg_swap_usd": 123
    },
    "relations": {
      "frequent_counterparts": [
        {
          "address": "<string>",
          "count": 123,
          "volume_usd": 123
        }
      ],
      "received_from": [
        {
          "address": "<string>",
          "count": 123,
          "volume_usd": 123
        }
      ]
    },
    "top_pairs": [
      {}
    ],
    "volume_timeline": [
      {
        "date": "<string>",
        "count": 123,
        "volume_usd": 123
      }
    ],
    "activity_heatmap": [
      {
        "date": "<string>",
        "count": 123
      }
    ],
    "recent_txs": [
      {
        "id": "<string>",
        "tx_hash": "<string>",
        "from_asset": "<string>",
        "to_asset": "<string>",
        "from_address": "<string>",
        "to_address": "<string>",
        "volume_usd": 123,
        "protocol": "<string>",
        "swap_date": "2023-11-07T05:31:56Z",
        "from_symbol": "<string>",
        "to_symbol": "<string>",
        "from_chain": "<string>",
        "to_chain": "<string>"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.leokit.dev/llms.txt

Use this file to discover all available pages before exploring further.

Endpoint

GET /leokit/explorer/wallet/{addr}
No authentication required. Cached for 60 seconds.

Request

Path parameterTypeRequiredDescription
addrstringYesWallet address (max 200 chars)
The endpoint uses case-insensitive matching, so EVM addresses match in any case.

Response

{
  "data": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "summary": {
      "total_volume_usd": 482015.67,
      "transaction_count": 122,
      "received_count": 14,
      "first_seen": "2025-08-15T09:14:22.000Z",
      "last_seen": "2026-04-27T18:32:11.000Z",
      "avg_swap_usd": 3950.95
    },
    "relations": {
      "frequent_counterparts": [
        { "address": "bc1q...", "count": 14, "volume_usd": 122480.55 }
      ],
      "received_from": [
        { "address": "0x1234...", "count": 3, "volume_usd": 9420.10 }
      ]
    },
    "top_pairs": [
      {
        "from_symbol": "USDC",
        "to_symbol": "BTC",
        "from_asset": "ETH.USDC-0xA0b...",
        "to_asset": "BTC.BTC",
        "count": 24,
        "volume_usd": 122480.55
      }
    ],
    "volume_timeline": [
      { "date": "2026-04-01", "count": 4, "volume_usd": 12480.55 }
    ],
    "activity_heatmap": [
      { "date": "2026-04-28", "count": 3 }
    ],
    "recent_txs": [
      /* up to 10 ExplorerTransaction objects, newest first */
    ]
  }
}

Field Reference

summary

FieldDescription
total_volume_usdUSD volume sent (where address is from_address)
transaction_countSwaps initiated by this wallet
received_countSwaps where this wallet was the recipient (excluding self-sends)
first_seenOldest swap timestamp (ISO-8601)
last_seenMost recent swap timestamp
avg_swap_usdtotal_volume_usd / transaction_count

relations

FieldDescription
frequent_counterpartsTop 5 destination addresses this wallet sent to
received_fromTop 5 source addresses that sent here (and aren’t this wallet)

top_pairs

Top 8 sent-from-this-wallet pairs by count.

volume_timeline

Last 30 days, daily buckets. Days with no activity are omitted.

activity_heatmap

Last 365 days, daily buckets, count only (no volume). For dashboard heatmap rendering.

recent_txs

Up to 10 most recent swaps initiated by this wallet (ExplorerTransaction shape — see overview).

Errors

StatusDescription
400Missing addr or longer than 200 chars
404No swaps found from or to this address

Caching

Cache-Control: public, max-age=60. The cache is per-address.

Examples

curl "https://api.leokit.dev/leokit/explorer/wallet/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
curl "https://api.leokit.dev/leokit/explorer/wallet/bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
curl "https://api.leokit.dev/leokit/explorer/wallet/thor1abc..."

Path Parameters

addr
string
required
Maximum string length: 200

Response

200 - application/json

Wallet summary, top pairs, heatmap, recent txs.

data
object
required