Token screener and token holders: free on-chain token API

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the contract address of PEPE on Ethereum
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/search?q=PEPE&limit=3",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# tokens whose name matches "Wrapped Ether"
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/search?q=Wrapped%20Ether&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the AERO token on Base
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/search?q=AERO&chain=base&limit=3",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the address alone
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/search?q=PEPE&limit=1",
    headers={"X-API-Key": API_KEY},
)
# then: jq -r '.[0].token_address'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# PEPE's top accumulators, by the address the search returned
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/holders?limit=10",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the five wallets with the largest accumulated net inflow of LINK
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x514910771af9ca656af840dff83e8264ecf986ca/holders?limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the longest ranking the route serves
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x514910771af9ca656af840dff83e8264ecf986ca/holders?limit=50",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# rows with no entity, the candidates for a closer look
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x514910771af9ca656af840dff83e8264ecf986ca/holders?limit=50",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.[] | select((.entity // "") == "") | {wallet, net_flow_usd, volume_usd, last_active}]'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# what a ranked wallet holds now on Ethereum, holdings of 1,000 USD and up
# WALLET: the top row of the ranking in the quick answer
holders = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x514910771af9ca656af840dff83e8264ecf986ca/holders?limit=5",
    headers={"X-API-Key": API_KEY},
).json()
WALLET = holders[0]["wallet"]
r = requests.get(
    f"https://data.vike.io/v1/onchain/wallets/{WALLET}/balances?chains=ethereum&min_usd=1000",
    headers={"X-API-Key": API_KEY},
)

"""Who is buying the token smart money is moving into? Screen, take the top token, label its biggest buyers.

Run:  VIKE_API_KEY=... python oc-early-buyers.py    (--dry-run lists the requests and makes none)
"""
import os
import sys
from urllib.parse import urlencode

NAME = "oc-early-buyers"
BASE = "https://data.vike.io"
DRY = "--dry-run" in sys.argv
# Wallet types that are intermediaries, not an owner deciding to buy; everything else is worth a look.
PLUMBING = {"cex", "defi", "mev"}


def fail(why):
    sys.exit(f"{NAME}: {why}")


def call(path, method="GET", **params):
    url = BASE + path + ("?" + urlencode(params) if params else "")
    if DRY:
        print(method, url)
        return None
    key = os.environ.get("VIKE_API_KEY") or fail("set VIKE_API_KEY")
    import requests

    r = requests.request(method, url, headers={"X-API-Key": key}, timeout=60)
    if r.status_code != 200:
        fail(f"{method} {path} answered HTTP {r.status_code}: {r.text[:200]}")
    return r.json()


def main():
    # Ethereum by default. A token is keyed by address: the screener's symbol is null for a token outside our registry.
    screen = call("/v1/onchain/tokens/screener", sort="smart_inflow", window="7d", limit=5)
    # --dry-run has no response to read
    rows = [{"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "volume_usd": 0}] if DRY else screen
    # The zero address is the chain's native coin (ETH), which often tops the screen; /transfers lists no buyers for it.
    rows = [r for r in rows or [] if int(r["token_address"], 16)]
    if not rows:
        fail("the screener returned no token contracts")

    # Ten rows, one side per call, and no limit parameter. usd_spent and net_usd are plain USD.
    for row in rows:
        token = row["token_address"]
        buyers = call(f"/v1/onchain/tokens/{token}/transfers", period="7d", tab="bought")
        if DRY or buyers:
            break
        print(f"{token} has no buyers in the window, trying the next token")
    else:
        fail(f"none of the top {len(rows)} screened tokens has buyers in the window")
    wallets = ["0xbbbbbbbbbb9cc5e90e3b3af64bdaf62c37eeffcb", "0x06cff7088619c7178f5e14f0b119458d08d2f5ef"]
    if not DRY:
        print(f"top smart-money inflow over 7d: {token}  (${row['volume_usd']:,.0f} volume)")
        wallets = [b["address"] for b in buyers]

    # A POST with no body: the addresses ride in the query string, at most 100 per call.
    labels = call("/v1/onchain/labels/batch", method="POST", addresses=",".join(wallets))
    if DRY:
        return
    if len(labels) != len(wallets):
        fail(f"/labels/batch returned {len(labels)} rows for {len(wallets)} wallets")
    by_wallet = {row["wallet"]: row for row in labels}
    for b in buyers:
        row = by_wallet.get(b["address"].lower(), {})
        kind = (row.get("wallet_type") or "") if row.get("found") else ""
        who = f"{row['entity']} ({kind})" if kind else "unlabelled"
        # bought counts every transfer in, so a flash-loan loop or a router "buys" billions and keeps nothing
        passed_on = b["net_tokens"] < 0.01 * b["bought"]
        flag = "   (passed it on)" if passed_on else "" if kind in PLUMBING else "   <- look here"
        print(f"  {b['address']}  bought ${b['usd_spent']:,.0f}  kept {b['net_tokens']:,.0f}  {who}{flag}")


if __name__ == "__main__":
    try:
        main()
    except Exception as e:  # a shape the example does not expect fails by name, not by traceback
        fail(f"{type(e).__name__}: {e}")

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# smart-money flow in PEPE over 7 days, picked out of the top 100 tokens by cohort volume
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?smart_money_only=true&sort=volume&window=7d&limit=100",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.[] | select(.token_address == "0x6982508145454ce325ddbe47a25d4ec3d2311933") | {token_address, symbol, net_flow_usd, volume_usd, in_usd, out_usd, unique_holders}'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the same row over 30 days
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?smart_money_only=true&sort=volume&window=30d&limit=100",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.[] | select(.token_address == "0x6982508145454ce325ddbe47a25d4ec3d2311933") | {token_address, symbol, net_flow_usd, volume_usd, in_usd, out_usd, unique_holders}'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# tokens the cohort sent out on net over 7 days
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?smart_money_only=true&sort=volume&window=7d&limit=100",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.[] | select(.net_flow_usd < 0) | {symbol, token_address, net_flow_usd, volume_usd}] | sort_by(.net_flow_usd)'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the tokens the cohort bought most on net over 7 days
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?sort=smart_inflow&window=7d&limit=20",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# PEPE's top 50 accumulators, keeping the unlabelled ones that have not moved PEPE since 1 December 2025
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/holders?limit=50",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.[] | select(.entity == "" and .last_active < "2025-12-01")]'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the full holder ranking
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/holders?limit=50",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# what the dormant wallet holds on Ethereum now
r = requests.get(
    "https://data.vike.io/v1/onchain/wallets/0xcbc9fad51b83a50dbdc058704fe1355d7b13068d/balances?chains=ethereum&min_usd=1000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# labels for the dormant candidates
r = requests.post(
    "https://data.vike.io/v1/onchain/labels/batch?addresses=0xcbc9fad51b83a50dbdc058704fe1355d7b13068d,0xe8f2c2d63443a0e403ba35c95dafe513eedbae12,0xd7f9f54194c633f36ccd5f3da84ad4a1c38cb2cb",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# PEPE's 50 biggest accumulators on Ethereum, with labels
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/holders?limit=50",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the PEPE contract on Ethereum
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/search?q=PEPE&limit=3",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the 24h buyers, first three rows, presentation strings dropped
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/transfers?period=24h&tab=bought",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.[:3] | map({address, bought, sold, net_tokens, net_usd})'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the 24h sellers
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/transfers?period=24h&tab=sold",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the 24h sellers of AERO on Base
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/0x940181a94a35a4569e4529a3cdfb74e38fd98631/transfers?period=24h&tab=sold&chain=base",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the Base tokens that gained the most supply, in USD, over the 7-day window
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?chain=base&sort=net_inflow&window=7d&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# Ethereum's 100 busiest tokens over the same window, each with its signed net flow
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?chain=ethereum&sort=volume&window=7d&limit=100",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the 100 Base tokens with the largest net inflow over 7 days
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?chain=base&sort=net_inflow&window=7d&limit=100",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the BNB Chain tokens that gained the most supply over 7 days
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?chain=bsc&sort=net_inflow&window=7d&limit=20",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the contract address of MORPHO on Base
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/search?q=MORPHO&chain=base&limit=3",
    headers={"X-API-Key": API_KEY},
)