# web3-entity-api

> Search and query labeled entities including exchanges, funds, protocols, and whales. Get entity categories, search for labeled addresses, and retrieve entity information. Use when user asks about exchange wallets, fund tracking, or labeled addresses.

- Author: noviulian
- Repository: noviulian/web3-skills
- Version: 20260122223039
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/noviulian/web3-skills
- Web: https://mule.run/skillshub/@@noviulian/web3-skills~web3-entity-api:20260122223039

---

---
name: web3-entity-api
description: Search and query labeled entities including exchanges, funds, protocols, and whales. Get entity categories, search for labeled addresses, and retrieve entity information. Use when user asks about exchange wallets, fund tracking, or labeled addresses.
license: MIT
compatibility: Requires Node.js (built-in modules only, no npm install needed). EVM chains only - not supported on Solana.
metadata:
  version: "1.0.0"
  author: web3-skills
  tags: [web3, blockchain, entity, labels, exchange, funds, evm]
---

# Web3 Entity API (EVM Only)

Query labeled entities on EVM chains including exchanges, funds, protocols, and whale wallets.

## Setup

```bash
/web3-api-key
```

## Common Queries

### Search Entities

```bash
cd $SKILL_DIR
node -e "
const { query } = require('./query');
query('/entities/search', {
  params: { q: 'binance', chain: 'eth' }
})
  .then(data => console.log('Found:', data.result?.length || 0))
  .catch(console.error);
"
```

### Get Entity Categories

```bash
cd $SKILL_DIR
node -e "
const { query } = require('./query');
query('/entities/categories')
  .then(data => console.log('Categories:', data.result))
  .catch(console.error);
"
```

### Get Entities by Category

```bash
cd $SKILL_DIR
node -e "
const { query } = require('./query');
query('/entities/categories/:categoryId/entities', { params: { chain: 'eth' }})
  .then(data => console.log('Entities:', data.result))
  .catch(console.error);
"
```

### Get Entity by ID

```bash
cd $SKILL_DIR
node -e "
const { query } = require('./query');
query('/entities/:entityId')
  .then(data => console.log(JSON.stringify(data, null, 2)))
  .catch(console.error);
"
```

## Supported Entity Categories

- **Exchanges:** Binance, Coinbase, Kraken, etc.
- **Funds:** a16z, Paradigm, Three Arrows, etc.
- **DeFi Protocols:** Uniswap, Aave, Compound, etc.
- **Whales:** Large wallet addresses
- **DEX Traders:** Active DEX traders

## See Also

- [EVM Endpoints Reference](references/EVM_ENDPOINTPOINTS.md)