api.slamai.dev · trending

Returns trending tokens across the entire blockchain for a specified activity window and optional category. The size of the increase in active wallets over the activity window determines the token's trending rank.

Call it in 30 seconds

// npm i x402-fetch viem
import { wrapFetchWithPayment } from "x402-fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount(process.env.PRIVATE_KEY); // funds USDC on Base
const wallet = createWalletClient({ account, chain: base, transport: http() });
const fetchWithPay = wrapFetchWithPayment(fetch, wallet);

// Pays the $0.001 USDC automatically on the 402, then returns the real response:
const res = await fetchWithPay("https://api.slamai.dev/chain/tokens/trending", { method: "GET" });
console.log(await res.json());

# pip install x402 eth-account httpx
import os, asyncio
from eth_account import Account
from x402.clients.httpx import x402HttpxClient

account = Account.from_key(os.environ["PRIVATE_KEY"])  # funds USDC on Base

async def main():
    async with x402HttpxClient(account=account) as client:
        # x402 handles the 402 -> pay ($0.001 USDC) -> retry automatically
        r = await client.get("https://api.slamai.dev/chain/tokens/trending")
        print((await r.aread()).decode())

asyncio.run(main())

# 1) An unpaid request returns HTTP 402 with the exact payment terms:
curl -i "https://api.slamai.dev/chain/tokens/trending?activity_window={'description': 'The length of time over which activity is measured.', 'enum': ['5min', '15min', '1h', '3h', '6h', '1d'], 'type': 'string'}&blockchain={'description': 'The blockchain name.', 'enum': ['ethereum', 'base'], 'required': True, 'type': 'string'}&category={'description': "Filters to a specific subset of tokens. Currently only 'virtuals' is supported on Base.", 'type': 'string'}&estimate_cost={'description': 'When true, returns only the SLAM token cost estimation.', 'type': 'boolean'}&num={'description': 'The maximum number of tokens to return. Maximum: 250.', 'format': 'int32', 'type': 'integer'}"

# 2) Paying + retrying requires an x402 client that can sign the USDC
#    authorization (curl alone cannot). See the JS / Python tabs below.

New to x402? Read the 5-minute quickstart →