• Intelligence API
  • MCP Server
  • WalletDNA
  • SLAM Nation
  • x402
Token
    PricegetPrice - HistorygetPrice (Exotic)getPrice (Exotic) - HistorygetTradesgetTrades (DNA)getTransfersgetTransfers (DNA)getHolder (Reputation)get
Chain
    Tokens (Trending)getTokens (Popular)getTokens (Popular) - HistorygetTokens (Newest)getTradesgetTrades (DNA)getTransfersgetTransfers (DNA)get
Wallet
    ReputationgetReputation (Full)getReputation (Holder)getTradesgetTrades (DNA)getTransfersgetTransfers (DNA)get
Pair
    TradesgetTrades (DNA)get
Schemas
powered by Zudoku
SLAMai
SLAMai

Pair

Endpointhttps://api.slamai.dev

Trades

GET
https://api.slamai.dev
/pair/trades

Returns trades for a specified liquidity pool, with optional filtering by side, trader, maker, block range, or timestamp range.

Trades › query Parameters

blockchain
string · enum · required

The blockchain network to query.

Enum values:
ethereum
base
Default: base
pair
string · required

The contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for.

trader_address
string

Filter trades where this address sent or received the specified token, regardless of whether they initiated the swap transaction.

maker_address
string

Filter trades where this address initiated the swap transaction.

side
string · enum

Specifies trade side for the implied quote token address. Wrapped native tokens and stablecoins are implied to be the base token in the trade, making the other token the quote. Otherwise the token with the lowest fully-diluted value (FDV) is assumed to be the quote token.

Enum values:
buy
sell
all
Default: all
min_usd
number · double

Minimum trade size in USD. Filters out trades with an estimated USD value below this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.

max_usd
number · double

Maximum trade size in USD. Filters out trades with an estimated USD value above this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.

num
integer · int32

The maximum number of records to return.

Default: 25
order
string

Sort order: asc (oldest first) or desc (newest first).

Default: desc
start_timestamp
string · date-time

Start searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.

start_block
integer · int32

Block number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.

start_log_index
integer · int32

Log index within the starting block to resume pagination or refine the starting point.

estimate_cost
boolean

When true returns the SLAM token cost for this query. It does not return any data or incur any actual charges.

Default: false

Trades › Headers

Authorization
string · required

Bearer token for authentication

Trades › Responses

OK

oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = object
type = object
Properties for Variant 1:
slam
number · double

The SLAM token cost for this API call.

chain
string

The name of the blockchain network (e.g., base).

object
object[]

List of token trade records matching the query.

GET/pair/trades
curl --request GET \
  --url 'https://api.slamai.dev/pair/trades?blockchain=base&pair=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'
shell
Example Responses
{
  "slam": 0.065,
  "chain": "base",
  "cursor": {
    "start_block": 34513846,
    "start_log_index": 416
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-21T23:19:35Z",
        "block": 34514514,
        "hash": "0x4bd2bf862024806b417822818e0f13a348a4ef2365caa95ec9385940ba7408d1",
        "method": "unxswap by order id",
        "log_index": 299
      },
      "side": "sell",
      "usd": 229.823854,
      "quote_token": {
        "address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
        "symbol": "VADER",
        "name": "VaderAI by Virtuals",
        "amount": 14460.0574485873
      },
      "base_token": {
        "address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
        "symbol": "VIRTUAL",
        "name": "Virtual Protocol",
        "amount": 193.550073538834
      },
      "price": 0.0134197098315315,
      "pair": {
        "address": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72",
        "name": "VIRTUAL/VADER",
        "labels": "Uniswap V2 Pool"
      },
      "trader": {
        "address": "0xFd03314B7f38294BA91a51f7A3F716d8Ba36C2bf"
      },
      "maker": {
        "address": "0xfd03314b7f38294ba91a51f7a3f716d8ba36c2bf"
      },
      "sender": {
        "address": "0x5e2F47bD7D4B357fCfd0Bb224Eb665773B1B9801",
        "name": "Dex Router"
      },
      "recipient": {
        "address": "0x6D5dF1d155d79279ABD65A98815F7853C2b3a005",
        "name": "VIRTUAL/AXR",
        "labels": "Uniswap V2 Pool"
      }
    }
  ]
}
json
application/json

Trades (DNA)

GET
https://api.slamai.dev
/pair/trades/dna

This endpoint retrieves trade data for a specified liquidity pool enriched with WalletDNA metrics. Developers can filter trades by size, side, or wallet behavior (IQ, Reputation, Flow, Mass, Epoch, Maker Presence). Responses include detailed trade, token, and wallet profiles, enabling advanced segmentation, smart-money tracking, and high-signal on-chain analytics in real time.

Trades (DNA) › query Parameters

blockchain
string · enum · required

The blockchain network to query.

Enum values:
ethereum
base
Default: base
pair
string · required

The contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for.

trader_address
string

Filter trades where this address sent or received the specified token, regardless of whether they initiated the swap transaction.

maker_address
string

Filter trades where this address initiated the swap transaction.

side
string · enum

Specifies trade side for the implied quote token address. Wrapped native tokens and stablecoins are implied to be the base token in the trade, making the other token the quote. Otherwise the token with the lowest fully-diluted value (FDV) is assumed to be the quote token.

Enum values:
buy
sell
all
Default: all
dna
string

Pipe-delimited list of walletDNA metrics to return in the response. Use 'all' to display every metric. Default: all. Valid options include: tokens, intelligence, reputation, flow, mass, epoch, makerPresence, entry, all. Example: intelligence|flow|mass|tokens

Default: all
min_usd
number · double

Minimum trade size in USD. Filters out trades with an estimated USD value below this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.

max_usd
number · double

Maximum trade size in USD. Filters out trades with an estimated USD value above this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.

min_iq
number · double

Minimum holder IQ (raw score). Filters out wallets with IQ scores below this threshold. Average IQ for all wallets trading a given token is 100.

max_iq
number · double

Maximum holder IQ (raw score). Filters out wallets with IQ scores above this threshold. Average IQ for all wallets trading a given token is 100. Max: Although possible, it is uncommon for wallets to have IQ scores above 200

min_intelligence
string · enum

Minimum holder Intelligence tier. Filters out wallets ranked below this tier.

Enum values:
idiot
dumb
below avg
avg
avg++
gifted
gifted++
genius
max_intelligence
string · enum

Maximum holder Intelligence tier. Filters out wallets ranked above this tier.

Enum values:
idiot
dumb
below avg
avg
avg++
gifted
gifted++
genius
min_reputation
number · double

Minimum raw holder Reputation. Filters out wallets with Reputation scores below this threshold.

max_reputation
number · double

Maximum raw holder Reputation. Filters out wallets with Reputation scores above this threshold. Max: 100

min_reputation_tier
string · enum

Minimum holder Reputation tier. Filters out wallets ranked below this tier.

Enum values:
a+
a
a−
b+
b
b−
c+
c
max_reputation_tier
string · enum

Maximum holder Reputation tier. Filters out wallets ranked above this tier.

Enum values:
a+
a
a−
b+
b
b−
c+
c
min_mass
number · double

Minimum raw holder Mass. Filters out wallets with Mass scores below this threshold.

max_mass
number · double

Maximum raw holder Mass. Filters out wallets with Mass scores above this threshold. Max: Scores above 250 are rare but possible.

min_mass_tier
string · enum

Minimum holder Mass tier. Filters out wallets ranked below this tier.

Enum values:
ghost
dust
plankton
shrimp
minnow
fish
dolphin
orca
max_mass_tier
string · enum

Maximum holder Mass tier. Filters out wallets ranked above this tier.

Enum values:
ghost
dust
plankton
shrimp
minnow
fish
dolphin
orca
min_epoch
number · double

Minimum raw holder Epoch. Filters out wallets with Epoch scores below this threshold.

max_epoch
number · double

Maximum raw holder Epoch. Filters out wallets with Epoch scores above this threshold. Max: 200

min_epoch_tier
string · enum

Minimum holder Epoch tier. Filters out wallets ranked below this tier.

Enum values:
newbie
rookie
core
veteran
early adopter
genesis
og
ultra og
max_epoch_tier
string · enum

Maximum holder Epoch tier. Filters out wallets ranked above this tier.

Enum values:
newbie
rookie
core
veteran
early adopter
genesis
og
ultra og
min_maker_presence
number · double

Minimum raw holder maker_presence. Filters out wallets with maker_presence scores below this threshold.

max_maker_presence
number · double

Maximum raw holder maker_presence. Filters out wallets with maker_presence scores above this threshold. Max: Scores above 200 are rare but possible.

min_maker_presence_tier
string · enum

Minimum holder maker_presence tier. Filters out wallets ranked below this tier.

Enum values:
hyperactive
highly active
active
engaged
occasional
minimal
micro
zero
max_maker_presence_tier
string · enum

Maximum holder maker_presence tier. Filters out wallets ranked above this tier.

Enum values:
hyperactive
highly active
active
engaged
occasional
minimal
micro
zero
min_flow
number · double

Minimum raw holder Flow. Filters out wallets with Flow scores below this threshold.

max_flow
number · double

Maximum raw holder Flow. Filters out wallets with Flow scores above this threshold. Max: Scores above 250 are rare but possible.

min_flow_tier
string · enum

Minimum holder Flow tier. Filters out wallets ranked below this tier.

Enum values:
dry
drip
trickle
stream
current
flood
torrent
tsunami
max_flow_tier
string · enum

Maximum holder Flow tier. Filters out wallets ranked above this tier.

Enum values:
dry
drip
trickle
stream
current
flood
torrent
tsunami
min_buy_flow
number · double

Minimum raw holder min_buy_flow. Filters out wallets with buy_flow scores below this threshold.

max_buy_flow
number · double

Maximum raw holder buy_flow. Filters out wallets with buy_flow scores above this threshold. Max: Scores above 250 are rare but possible.

min_buy_flow_tier
string · enum

Minimum holder buy_flow tier. Filters out wallets ranked below this tier.

Enum values:
dry
drip
trickle
stream
current
flood
torrent
tsunami
max_buy_flow_tier
string · enum

Maximum holder buy_flow tier. Filters out wallets ranked above this tier.

Enum values:
dry
drip
trickle
stream
current
flood
torrent
tsunami
min_sell_flow
number · double

Minimum raw holder sell_flow. Filters out wallets with sell_flow scores below this threshold.

max_sell_flow
number · double

Maximum raw holder sell_flow. Filters out wallets with sell_flow scores above this threshold. Max: Scores above 250 are rare but possible.

min_sell_flow_tier
string · enum

Minimum holder sell_flow tier. Filters out wallets ranked below this tier.

Enum values:
dry
drip
trickle
stream
current
flood
torrent
tsunami
max_sell_flow_tier
string · enum

Maximum holder sell_flow tier. Filters out wallets ranked above this tier.

Enum values:
dry
drip
trickle
stream
current
flood
torrent
tsunami
num
integer · int32

The maximum number of trade records to return. Maximum: 1000.

Default: 25
order
string · enum

Sort order for results: asc (oldest first) or desc (newest first).

Enum values:
asc
desc
Default: desc
start_timestamp
string · date-time

Start searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.

start_block
integer · int32

Block number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.

start_log_index
integer · int32

Log index within the starting block to resume pagination or refine the starting point.

estimate_cost
boolean

When true returns the SLAM token cost for this query. It does not return any data or incur any actual charges.

Default: false

Trades (DNA) › Headers

Authorization
string · required

Bearer token for authentication

Trades (DNA) › Responses

OK

oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = object
type = object
Properties for Variant 1:
slam
number · double

The SLAM token cost for this API call.

chain
string

The name of the blockchain network (e.g., base).

object
object[]

List of token trade records matching the query.

GET/pair/trades/dna
curl --request GET \
  --url 'https://api.slamai.dev/pair/trades/dna?blockchain=base&pair=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'
shell
Example Responses
{
  "slam": 5.65857866142481,
  "chain": "base",
  "cursor": {
    "start_block": 34761645,
    "start_log_index": 508
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-27T17:16:31Z",
        "block": 34762822,
        "hash": "0xf57796859582734ddaa55b214cd9a6613044ec6c831662a14f61b44f76864fac",
        "log_index": 170
      },
      "side": "sell",
      "usd": 397.743919,
      "quote_token": {
        "address": "0x4f9fd6be4a90f2620860d680c0d4d5fb53d1a825",
        "symbol": "AIXBT",
        "name": "aixbt by Virtuals",
        "amount": 3792.94561936705
      },
      "base_token": {
        "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "amount": 398.741271
      },
      "price": 0.10540407822228,
      "pair": {
        "address": "0xf1fdc83c3a336bdbdc9fb06e318b08eaddc82ff4",
        "name": "AIXBT/USDC",
        "labels": "Uniswap V3 Pool"
      },
      "trader": {
        "address": "0xB7B8F759E8Bd293b91632100f53a45859832f463",
        "quote_token_holding": {
          "balance": 191359.341236202,
          "staked_pct": 0.019235,
          "value_usd": 20312.1217
        },
        "intelligence": {
          "tier": "Avg++",
          "iq": 117.4
        },
        "reputation": {
          "tier": "A",
          "raw": 94.71
        },
        "mass": {
          "tier": "Dolphin",
          "raw": 117.42
        },
        "epoch": {
          "tier": "Core",
          "raw": 49.23
        },
        "maker_presence": {
          "tier": "Zero",
          "raw": 0
        },
        "flow": {
          "buy": {
            "tier": "Flood",
            "raw": 144.7
          },
          "sell": {
            "tier": "Tsunami",
            "raw": 224.85
          },
          "total": {
            "tier": "Tsunami",
            "raw": 209.3
          }
        },
        "entry": {
          "method": "DEX",
          "token_amount": 37958.904633452,
          "block": 31588672,
          "utc": "2025-06-15T05:51:31"
        }
      },
      "maker": {
        "address": "0x45e10a07a38764d84bbf0f0445dd24eedc3e7bd8"
      },
      "sender": {
        "address": "0xB7B8F759E8Bd293b91632100f53a45859832f463"
      },
      "recipient": {
        "address": "0xB7B8F759E8Bd293b91632100f53a45859832f463"
      }
    }
  ]
}
json
application/json

Wallet