API Documentation

Build bots, dashboards, and automated trading systems with the CryptoPulse REST API.

EVM chains supported

100+

Labeled whale wallets

<200ms

Average response time

🌐 Base URL: https://cryptopulse.uno/api

✅ JSON responses

🔑 Bearer token auth

⚡ Quick Start

1. Get your API key from the Dashboard (requires Trader or API plan)

2. Make your first request:

curl -H "Authorization: Bearer cpk_your_api_key_here" \
  https://cryptopulse.uno/api/whales?chain=ethereum&limit=5

3. Or use JavaScript:

const res = await fetch("https://cryptopulse.uno/api/whales?chain=ethereum", {
  headers: { "Authorization": "Bearer cpk_your_api_key_here" }
});
const { transactions } = await res.json();
console.log(`Found ${transactions.length} whale moves`);

4. Python example:

import requests

headers = {"Authorization": "Bearer cpk_your_api_key_here"}
r = requests.get("https://cryptopulse.uno/api/wallet/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
                  params={"multichain": "true"}, headers=headers)
wallet = r.json()
print(f"Score: {wallet['score']['overall']}/100 — {wallet['score']['classification']}")

📊 Rate Limits

Plan	Price	Wallet Lookups	API Calls/Day	API Keys	Features
Free	$0	10/day	—	—	Dashboard only
Pro	$19/mo	100/day	—	—	Priority alerts
Trader	$49/mo	500/day	500/day	3 keys	Full API access
API	$99/mo	5,000/day	5,000/day	10 keys	Full API + webhooks

Endpoints

GET/api/whalesFree (delayed 30min) / Pro+ (real-time)

Get recent whale transactions across chains

Parameters

Name	Type	Required	Default	Description
chain	string	No	ethereum	Chain: ethereum, base, bsc, arbitrum, polygon, optimism, avalanche...
limit	number	No	20	Max results (1-100)

Example

curl -H "Authorization: Bearer YOUR_API_KEY" https://cryptopulse.uno/api/whales?chain=ethereum&limit=5

Response

{
  "chain": "ethereum",
  "count": 5,
  "transactions": [
    {
      "hash": "0xabc...def",
      "chain": "ethereum",
      "from": "0x28C6...d60",
      "to": "0xd8dA...045",
      "value": "500.0000",
      "valueUSD": 1750000,
      "token": "ETH",
      "tokenSymbol": "ETH",
      "type": "transfer",
      "fromLabel": "Binance Hot Wallet",
      "toLabel": "vitalik.eth",
      "timestamp": 1708886400,
      "blockNumber": 19320000
    }
  ],
  "updatedAt": "2026-02-28T15:30:00Z"
}

🧪 Try It

GET/api/wallet/:addressFree (10/day) / Pro (100/day) / API (5000/day)

Scan wallet — balance, tokens, transactions, intelligence score

Parameters

Name	Type	Required	Default	Description
address	string	Yes	—	EVM wallet address (0x...)
chain	string	No	ethereum	Single chain to query
multichain	boolean	No	false	Scan all 34 chains in parallel

Example

curl -H "Authorization: Bearer YOUR_API_KEY" https://cryptopulse.uno/api/wallet/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?multichain=true

Response

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain": "ethereum",
  "label": "vitalik.eth",
  "tags": ["🐋 Whale", "Ethereum Foundation"],
  "balance": "1234.5678",
  "balanceUSD": 4320987.30,
  "score": {
    "overall": 92,
    "tier": "🐋",
    "classification": "Whale",
    "breakdown": { "age": 25, "activity": 22, "diversity": 20, "volume": 25 },
    "riskFlags": [],
    "insights": ["Top 0.01% wallet", "Active DeFi user"]
  },
  "stats": {
    "totalTxCount": 1847,
    "uniqueTokensTraded": 89,
    "totalValueMovedUSD": 890000000,
    "firstTxDate": "2015-07-30",
    "lastTxDate": "2026-02-28"
  },
  "tokenHoldings": [...],
  "recentTokenTransfers": [...],
  "connections": { "exchanges": [...], "defi": [...], "frequentContacts": [...] }
}

🧪 Try It

GET/api/marketFree / All plans

Market overview — prices, market cap, fear & greed index

Example

curl -H "Authorization: Bearer YOUR_API_KEY" https://cryptopulse.uno/api/market

Response

{
  "overview": {
    "totalMarketCap": 3200000000000,
    "totalVolume24h": 98000000000,
    "btcDominance": 52.3,
    "fearGreedIndex": 72,
    "fearGreedLabel": "Greed"
  },
  "prices": [
    { "id": "bitcoin", "symbol": "btc", "price": 95420, "change24h": 2.1, "marketCap": 1890000000000 },
    { "id": "ethereum", "symbol": "eth", "price": 3520, "change24h": -0.5, "marketCap": 423000000000 }
  ]
}

🧪 Try It

GET/api/chainsFree / All plans

List all 34 supported chains with RPC status

Example

curl https://cryptopulse.uno/api/chains

Response

{
  "chains": [
    { "id": "ethereum", "name": "Ethereum", "symbol": "ETH", "explorerUrl": "https://etherscan.io" },
    { "id": "base", "name": "Base", "symbol": "ETH", "explorerUrl": "https://basescan.org" },
    ...
  ],
  "total": 34
}

🧪 Try It

GET/api/keysTrader / API plan

List your API keys (requires auth cookie)

Example

# Use dashboard UI to manage keys

Response

{ "keys": [{ "id": "...", "keyPrefix": "cpk_a1b2c3d4", "name": "My Bot", "callsToday": 42, "callsTotal": 1337, "createdAt": "..." }] }

🧪 Try It

POST/api/keysTrader / API plan

Create a new API key

Parameters

Name	Type	Required	Default	Description
name	string	No	Default	Label for the key

Example

curl -X POST -H "Content-Type: application/json" -d '{"name":"My Bot"}' https://cryptopulse.uno/api/keys

Response

{ "key": "cpk_abc123...full_key", "id": "...", "prefix": "cpk_abc123..", "name": "My Bot", "message": "Save this key — it won't be shown again!" }

🧪 Try It

Error Codes

Code	Meaning
200	Success
400	Bad request — invalid parameters
401	Unauthorized — invalid or missing API key
403	Forbidden — plan doesn't include this feature
429	Rate limit reached — upgrade plan or wait for daily reset
500	Server error

Ready to build?

Get API access with a Trader ($49/mo) or API ($99/mo) plan. Start building in minutes.

View Plans →Dashboard →