SLAMai

Wallet

Endpointhttps://api.slamai.dev

Reputation

GET

https://api.slamai.dev

/wallet/reputation

Returns reputation scores for one or more wallets using on-chain behavioral analysis across their token portfolio.

Reputation › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

addresses

string · required

Pipe-delimited list of wallet addresses. Max: 75

at_block_number

integer · int32

Block number at which to calculate reputation

at_timestamp

string · date-time

UTC timestamp for calculating reputation (ignored if block number is present)

estimate_cost

boolean

If true, only the SLAM token cost is returned

Default: false

Reputation › Headers

Authorization

string · required

Bearer token for authentication

Reputation › Responses

slam

number · double

SLAM token cost for this API call

chain

string

Blockchain network name (e.g., 'base')

block

integer · int32

Block number for the reputation snapshot

utc

string

UTC timestamp of the snapshot in ISO 8601 format

object[]

List of wallet reputation records

GET/wallet/reputation

curl --request GET \
  --url 'https://api.slamai.dev/wallet/reputation?blockchain=base&addresses=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 6.6,
  "chain": "base",
  "block": 33263314,
  "utc": "2025-07-24T00:12:55Z",
  "wallets": [
    {
      "address": "0xfe3773445d8658e10a95ff9d3168eedd5a9cc66b",
      "reputation": {
        "tier": "B",
        "depth": "Saturated",
        "raw": 83.79
      }
    }
  ]
}

json

application/json

Reputation (Full)

GET

https://api.slamai.dev

/wallet/reputation/full

Returns composite reputation scores along with per-token scores for all tokens held in each wallet.

Reputation (Full) › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

addresses

string · required

Pipe-delimited list of wallet addresses. Max: 75

at_block_number

integer · int32

Block number to calculate reputation at

at_timestamp

string · date-time

UTC timestamp to calculate reputation at (ignored if block number is present)

estimate_cost

boolean

If true, only the SLAM token cost is returned

Default: false

Reputation (Full) › Headers

Authorization

string · required

Bearer token for authentication

Reputation (Full) › Responses

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

slam

number · double

SLAM token cost for this API call

chain

string

Blockchain network name

block

integer · int32

Block number used for reputation snapshot

utc

string

UTC ISO 8601 timestamp of snapshot

object[]

List of wallets and their full reputation profiles

GET/wallet/reputation/full

curl --request GET \
  --url 'https://api.slamai.dev/wallet/reputation/full?blockchain=base&addresses=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 22.982534871017677,
  "chain": "base",
  "block": 33509624,
  "utc": "2025-07-29T17:03:15Z",
  "wallets": [
    {
      "address": "0x6c8a03ed520f0ed8398827afb7ceb2a0f44d7acc",
      "reputation": {
        "tier": "B-",
        "depth": "Mid",
        "raw": 80.34
      },
      "tokens": [
        {
          "token": {
            "address": "0x30c1d9b1cbd5590d6da01069a331e110482a8a91",
            "symbol": "Mog",
            "name": "Based Mog Coin"
          },
          "reputation": {
            "tier": "C+",
            "raw": 77.29,
            "weight": 0.01805
          }
        },
        {
          "token": {
            "address": "0x8890de1637912fbbba36b8b19365cdc99122bd6e",
            "symbol": "SLAP",
            "name": "Slap"
          },
          "reputation": {
            "tier": "C+",
            "raw": 77.7,
            "weight": 0.04324
          }
        },
        {
          "token": {
            "address": "0x163fb041c2e0026fcfa8e215f123b2cd55b2da81",
            "symbol": "HAIR",
            "name": "Base Wif Hair "
          },
          "reputation": {
            "tier": "C+",
            "raw": 77.92,
            "weight": 0.0563
          }
        },
        {
          "token": {
            "address": "0x09b052085e9c6291fbf0dfb0918c861bcb47eb25",
            "symbol": "RICKY",
            "name": "Ricky the Raccoon"
          },
          "reputation": {
            "tier": "C+",
            "raw": 78.24,
            "weight": 0.07612
          }
        },
        {
          "token": {
            "address": "0x0c3e14ca158e874f513c70caafeea49a85d4ccc6",
            "symbol": "BASE-69",
            "name": "Brian Armstrong Saves Ethereum"
          },
          "reputation": {
            "tier": "C+",
            "raw": 79.6,
            "weight": 0.15958
          }
        },
        {
          "token": {
            "address": "0x03264d29e2498284c0043d8f83e040778ab6290a",
            "symbol": "aura",
            "name": "based aura"
          },
          "reputation": {
            "tier": "B-",
            "raw": 81.16,
            "weight": 0.25552
          }
        },
        {
          "token": {
            "address": "0x26c69e4924bd0d7d52d680b33616042ee13f621c",
            "symbol": "SALUKI",
            "name": "SALUKI"
          },
          "reputation": {
            "tier": "B-",
            "raw": 81.65,
            "weight": 0.28584
          }
        }
      ]
    }
  ]
}

json

application/json

Reputation (Holder)

GET

https://api.slamai.dev

/wallet/holder/reputation

Returns reputation scores for a wallet across one or more specific tokens.

Reputation (Holder) › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

wallet_address

string · required

Address of the wallet to query

token_addresses

string · required

Pipe-delimited list of token addresses to query. Max: 100.

token_symbols

string

Pipe-delimited list of token symbols to query. Max: 100.

at_block_number

integer · int32

Block number to calculate reputation at

at_timestamp

string · date-time

UTC timestamp to calculate reputation at (ignored if block number is present)

estimate_cost

boolean

If true, only the SLAM token cost is returned

Default: false

Reputation (Holder) › Headers

Authorization

string · required

Bearer token for authentication

Reputation (Holder) › Responses

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

slam

number · double

SLAM token cost for this API call

chain

string

Blockchain network name

block

integer · int32

Block number for the reputation snapshot

utc

string

UTC timestamp in ISO 8601 format

object[]

List of token-specific reputation records for the wallet

GET/wallet/holder/reputation

curl --request GET \
  --url 'https://api.slamai.dev/wallet/holder/reputation?blockchain=base&wallet_address=%3Cstring%3E&token_addresses=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 1.32,
  "chain": "base",
  "block": 33288759,
  "utc": "2025-07-24T14:21:05Z",
  "holders": [
    {
      "wallet": {
        "address": "0xfe3773445d8658e10a95ff9d3168eedd5a9cc66b"
      },
      "token": {
        "address": "0xea87169699dabd028a78d4b91544b4298086baf6",
        "symbol": "SWARM",
        "name": "The SWARM (by SLAMai) by Virtuals"
      },
      "reputation": {
        "tier": "B",
        "raw": 84.35,
        "weight": 0.91829
      }
    }
  ]
}

json

application/json

Trades

GET

https://api.slamai.dev

/wallet/trades

Returns trades for a specified wallet address as the trader (default) or maker, with optional filtering by token, paired token, pair, side, block range, or timestamp range.

Trades › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

wallet_address

string · required

The wallet address to fetch trades for.

wallet_role

string · enum

Filter trades where the specified wallet_address acted in the given role. Trader (default) where the wallet sent or received the token, regardless of initiating the swap transaction, or maker where the wallet initiated the swap transaction.

Enum values:

trader

maker

Default: trader

token_address

string

The ERC-20 token contract address to fetch trades for.

paired_token_address

string

Filter trades where the specified token was swapped against this paired token address, regardless of pool.

pair

string

The contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for. When present, overrides token_address and paired_token_address.

side

string · enum

Specifies trade side for the given token_address.

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

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching 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/wallet/trades

curl --request GET \
  --url 'https://api.slamai.dev/wallet/trades?blockchain=base&wallet_address=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 0.065,
  "chain": "base",
  "cursor": {
    "start_block": 31384774,
    "start_log_index": 45
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-18T06:46:35Z",
        "block": 34355124,
        "hash": "0x09c715d8f2c16134119d9cc53a600a09b49d1fa20dcc6cc1a8c02b4a86439d51",
        "method": "swap simple mode",
        "log_index": 582
      },
      "side": "sell",
      "usd": 10726.204254,
      "quote_token": {
        "address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
        "symbol": "VADER",
        "name": "VaderAI by Virtuals",
        "amount": 618854.223280559
      },
      "base_token": {
        "address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
        "symbol": "VIRTUAL",
        "name": "Virtual Protocol",
        "amount": 8899.78611752252
      },
      "price": 0.0141539462344898,
      "pair": {
        "address": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72",
        "name": "VIRTUAL/VADER",
        "labels": "Uniswap V2 Pool"
      },
      "trader": {
        "address": "0x45D964A0E60e45a5144Dc2d2273503B01f83D388"
      },
      "maker": {
        "address": "0x45d964a0e60e45a5144dc2d2273503b01f83d388"
      },
      "sender": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      },
      "recipient": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      }
    }
  ]
}

json

application/json

Trades (DNA)

GET

https://api.slamai.dev

/wallet/trades/dna

The Wallet Trades DNA endpoint returns all trades for a specific wallet, enriched with HolderDNA metrics calculated at the time of each swap. Supports DNA-based filters, allowing segmentation across different tokens. This lets you track how wallet intelligence, reputation, and other behavioral signals evolve per token throughout trading history.

Trades (DNA) › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

wallet_address

string · required

The wallet address to fetch trades for.

wallet_role

string · enum

Filter trades where the specified wallet_address acted in the given role. Valid values: trader (default) where the wallet sent or received the token, regardless of initiating the swap transaction, or maker where the wallet initiated the swap transaction.

Enum values:

trader

maker

Default: trader

token_address

string

The ERC-20 token contract address to fetch trades for.

paired_token_address

string

Filter trades where the specified token was swapped against this paired token address, regardless of pool.

pair

string

The contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for. When present, overrides token_address and paired_token_address.

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

max_usd

number · double

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−

b−

max_reputation_tier

string · enum

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

Enum values:

a−

b−

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

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

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

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching 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/wallet/trades/dna

curl --request GET \
  --url 'https://api.slamai.dev/wallet/trades/dna?blockchain=base&wallet_address=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 0.065,
  "chain": "base",
  "cursor": {
    "start_block": 31384774,
    "start_log_index": 45
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-18T06:46:35Z",
        "block": 34355124,
        "hash": "0x09c715d8f2c16134119d9cc53a600a09b49d1fa20dcc6cc1a8c02b4a86439d51",
        "method": "swap simple mode",
        "log_index": 582
      },
      "side": "sell",
      "usd": 10726.204254,
      "quote_token": {
        "address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
        "symbol": "VADER",
        "name": "VaderAI by Virtuals",
        "amount": 618854.223280559
      },
      "base_token": {
        "address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
        "symbol": "VIRTUAL",
        "name": "Virtual Protocol",
        "amount": 8899.78611752252
      },
      "price": 0.0141539462344898,
      "pair": {
        "address": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72",
        "name": "VIRTUAL/VADER",
        "labels": "Uniswap V2 Pool"
      },
      "trader": {
        "address": "0x45D964A0E60e45a5144Dc2d2273503B01f83D388"
      },
      "maker": {
        "address": "0x45d964a0e60e45a5144dc2d2273503b01f83d388"
      },
      "sender": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      },
      "recipient": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      }
    }
  ]
}

json

application/json

Transfers

GET

https://api.slamai.dev

/wallet/transfers

Returns token transfers for a specified wallet address, with optional filtering by token address, participant address, direction, block range, or timestamp range. You may filter by either tokenAddress or address, but not both.

Transfers › query Parameters

blockchain

string · enum · required

The blockchain to query

Enum values:

ethereum

base

Default: base

wallet_address

string · required

The wallet address to fetch transfers for.

address

string

Filter transfers where this address is either the sender or the receiver.

token_address

string

The ERC-20 token contract address to fetch transfers for.

direction

string · enum

Transfer direction relative to the address.

Enum values:

sent

received

all

Default: all

num

integer · int32

The maximum number of transfer records to return (1-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). Overrides start_block when provided.

start_block

integer · int32

Block number to start the search from (inclusive).

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 only the SLAM token cost for this query.

Default: false

Transfers › Headers

Authorization

string · required

Bearer token for authentication

Transfers › Responses

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

slam

number · double

The SLAM token cost for this API call.

chain

string

The blockchain network name (e.g., 'base').

object

object[]

List of token transfer records matching the query.

GET/wallet/transfers

curl --request GET \
  --url 'https://api.slamai.dev/wallet/transfers?blockchain=base&wallet_address=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 0.00960899547185145,
  "chain": "base",
  "cursor": {
    "start_block": 33297128,
    "start_log_index": 995
  },
  "transfers": [
    {
      "transaction": {
        "utc": "2025-07-24T19:01:47Z",
        "block": 33297180,
        "hash": "0xec1765d57f51a6a7274c33991b42e1c1bff6f760462c0409b13a2632a8ed4934",
        "method": "execute",
        "log_index": 403
      },
      "token": {
        "address": "0x98d0baa52b2d063e780de12f615f963fe8537553",
        "symbol": "KAITO",
        "name": "KAITO"
      },
      "from": {
        "address": "0x6a0a87ec975DF3D2A4d6159Db55B034D4313ED66"
      },
      "to": {
        "address": "0x37bb450b17721c6720040a150029e504766e9777",
        "name": "WETH/KAITO",
        "labels": "Uniswap V3 Pool"
      },
      "amount": {
        "raw": 293120070211072300,
        "decimals": 0.2931200702110723
      }
    }
  ]
}

json

application/json

Transfers (DNA)

GET

https://api.slamai.dev

/wallet/transfers/dna

Returns token transfer records for a given wallet address, enriched with WalletDNA analytics—including sender and receiver wallet tiers ("size"), labels, current balances (token & USD), and each address's share of supply. Each record includes FDV and live token pricing. Supports filtering by participant address, direction, block range, or timestamp. Longer response times should be expected due to the richness of the data.

Transfers (DNA) › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

wallet_address

string · required

The wallet address to fetch transfers for.

address

string

Optional filter to only include transfers involving this address

token_address

string

Optional filter transfers for this ERC-20 token contract address.

direction

string · enum

Transfer direction relative to the address.

Enum values:

sent

received

all

Default: all

num

integer · int32

Max number of transfer records to return (max 100)

Default: 25

order

string · enum

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

Enum values:

asc

desc

Default: desc

start_timestamp

string · date-time

Start from this UTC timestamp (overrides start_block)

start_block

integer · int32

Block number to start from (inclusive)

start_log_index

integer · int32

Log index within the block to resume pagination

estimate_cost

boolean

When true, returns only the SLAM cost without performing the query

Default: false

Transfers (DNA) › Headers

Authorization

string · required

Bearer token for authentication

Transfers (DNA) › Responses

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

slam

number · double

SLAM token cost for this API call

chain

string

Blockchain network name (e.g., 'base')

object

object[]

List of enriched token transfers with WalletDNA

GET/wallet/transfers/dna

curl --request GET \
  --url 'https://api.slamai.dev/wallet/transfers/dna?blockchain=base&wallet_address=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 0.0096,
  "chain": "base",
  "cursor": {
    "start_block": 33297128,
    "start_log_index": 995
  },
  "transfers": [
    {
      "transaction": {
        "utc": "2025-07-24T19:01:47Z",
        "block": 33297180,
        "hash": "0xec17...",
        "method": "execute",
        "log_index": 403
      },
      "token": {
        "address": "0x98d0...",
        "symbol": "KAITO",
        "name": "KAITO",
        "usd": 0.45,
        "fdv": 40000000
      },
      "from": {
        "address": "0x6a0a...",
        "balance": {
          "decimals": 1.23,
          "usd": 0.56,
          "supply_share": 0.0001
        },
        "mass": {
          "tier": "Fish",
          "raw": 100
        }
      },
      "to": {
        "address": "0x37bb...",
        "name": "WETH/KAITO",
        "labels": "Uniswap V3 Pool",
        "balance": {
          "decimals": 99.1,
          "usd": 50.3,
          "supply_share": 0.0501
        },
        "mass": {
          "tier": "Whale",
          "raw": 1500
        }
      },
      "amount": {
        "raw": 293120000000000000,
        "decimals": 0.2931,
        "usd": 0.12
      }
    }
  ]
}

json

application/json

Chain Pair

SLAMai

Wallet

Endpointhttps://api.slamai.dev

Reputation

GET

https://api.slamai.dev

/wallet/reputation

Returns reputation scores for one or more wallets using on-chain behavioral analysis across their token portfolio.

Reputation › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

addresses

string · required

Pipe-delimited list of wallet addresses. Max: 75

at_block_number

integer · int32

Block number at which to calculate reputation

at_timestamp

string · date-time

UTC timestamp for calculating reputation (ignored if block number is present)

estimate_cost

boolean

If true, only the SLAM token cost is returned

Default: false

Reputation › Headers

Authorization

string · required

Bearer token for authentication

Reputation › Responses

slam

number · double

SLAM token cost for this API call

chain

string

Blockchain network name (e.g., 'base')

block

integer · int32

Block number for the reputation snapshot

utc

string

UTC timestamp of the snapshot in ISO 8601 format

object[]

List of wallet reputation records

GET/wallet/reputation

curl --request GET \
  --url 'https://api.slamai.dev/wallet/reputation?blockchain=base&addresses=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 6.6,
  "chain": "base",
  "block": 33263314,
  "utc": "2025-07-24T00:12:55Z",
  "wallets": [
    {
      "address": "0xfe3773445d8658e10a95ff9d3168eedd5a9cc66b",
      "reputation": {
        "tier": "B",
        "depth": "Saturated",
        "raw": 83.79
      }
    }
  ]
}

json

application/json

Reputation (Full)

GET

https://api.slamai.dev

/wallet/reputation/full

Returns composite reputation scores along with per-token scores for all tokens held in each wallet.

Reputation (Full) › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

addresses

string · required

Pipe-delimited list of wallet addresses. Max: 75

at_block_number

integer · int32

Block number to calculate reputation at

at_timestamp

string · date-time

UTC timestamp to calculate reputation at (ignored if block number is present)

estimate_cost

boolean

If true, only the SLAM token cost is returned

Default: false

Reputation (Full) › Headers

Authorization

string · required

Bearer token for authentication

Reputation (Full) › Responses

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

slam

number · double

SLAM token cost for this API call

chain

string

Blockchain network name

block

integer · int32

Block number used for reputation snapshot

utc

string

UTC ISO 8601 timestamp of snapshot

object[]

List of wallets and their full reputation profiles

GET/wallet/reputation/full

curl --request GET \
  --url 'https://api.slamai.dev/wallet/reputation/full?blockchain=base&addresses=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 22.982534871017677,
  "chain": "base",
  "block": 33509624,
  "utc": "2025-07-29T17:03:15Z",
  "wallets": [
    {
      "address": "0x6c8a03ed520f0ed8398827afb7ceb2a0f44d7acc",
      "reputation": {
        "tier": "B-",
        "depth": "Mid",
        "raw": 80.34
      },
      "tokens": [
        {
          "token": {
            "address": "0x30c1d9b1cbd5590d6da01069a331e110482a8a91",
            "symbol": "Mog",
            "name": "Based Mog Coin"
          },
          "reputation": {
            "tier": "C+",
            "raw": 77.29,
            "weight": 0.01805
          }
        },
        {
          "token": {
            "address": "0x8890de1637912fbbba36b8b19365cdc99122bd6e",
            "symbol": "SLAP",
            "name": "Slap"
          },
          "reputation": {
            "tier": "C+",
            "raw": 77.7,
            "weight": 0.04324
          }
        },
        {
          "token": {
            "address": "0x163fb041c2e0026fcfa8e215f123b2cd55b2da81",
            "symbol": "HAIR",
            "name": "Base Wif Hair "
          },
          "reputation": {
            "tier": "C+",
            "raw": 77.92,
            "weight": 0.0563
          }
        },
        {
          "token": {
            "address": "0x09b052085e9c6291fbf0dfb0918c861bcb47eb25",
            "symbol": "RICKY",
            "name": "Ricky the Raccoon"
          },
          "reputation": {
            "tier": "C+",
            "raw": 78.24,
            "weight": 0.07612
          }
        },
        {
          "token": {
            "address": "0x0c3e14ca158e874f513c70caafeea49a85d4ccc6",
            "symbol": "BASE-69",
            "name": "Brian Armstrong Saves Ethereum"
          },
          "reputation": {
            "tier": "C+",
            "raw": 79.6,
            "weight": 0.15958
          }
        },
        {
          "token": {
            "address": "0x03264d29e2498284c0043d8f83e040778ab6290a",
            "symbol": "aura",
            "name": "based aura"
          },
          "reputation": {
            "tier": "B-",
            "raw": 81.16,
            "weight": 0.25552
          }
        },
        {
          "token": {
            "address": "0x26c69e4924bd0d7d52d680b33616042ee13f621c",
            "symbol": "SALUKI",
            "name": "SALUKI"
          },
          "reputation": {
            "tier": "B-",
            "raw": 81.65,
            "weight": 0.28584
          }
        }
      ]
    }
  ]
}

json

application/json

Reputation (Holder)

GET

https://api.slamai.dev

/wallet/holder/reputation

Returns reputation scores for a wallet across one or more specific tokens.

Reputation (Holder) › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

wallet_address

string · required

Address of the wallet to query

token_addresses

string · required

Pipe-delimited list of token addresses to query. Max: 100.

token_symbols

string

Pipe-delimited list of token symbols to query. Max: 100.

at_block_number

integer · int32

Block number to calculate reputation at

at_timestamp

string · date-time

UTC timestamp to calculate reputation at (ignored if block number is present)

estimate_cost

boolean

If true, only the SLAM token cost is returned

Default: false

Reputation (Holder) › Headers

Authorization

string · required

Bearer token for authentication

Reputation (Holder) › Responses

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

slam

number · double

SLAM token cost for this API call

chain

string

Blockchain network name

block

integer · int32

Block number for the reputation snapshot

utc

string

UTC timestamp in ISO 8601 format

object[]

List of token-specific reputation records for the wallet

GET/wallet/holder/reputation

curl --request GET \
  --url 'https://api.slamai.dev/wallet/holder/reputation?blockchain=base&wallet_address=%3Cstring%3E&token_addresses=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 1.32,
  "chain": "base",
  "block": 33288759,
  "utc": "2025-07-24T14:21:05Z",
  "holders": [
    {
      "wallet": {
        "address": "0xfe3773445d8658e10a95ff9d3168eedd5a9cc66b"
      },
      "token": {
        "address": "0xea87169699dabd028a78d4b91544b4298086baf6",
        "symbol": "SWARM",
        "name": "The SWARM (by SLAMai) by Virtuals"
      },
      "reputation": {
        "tier": "B",
        "raw": 84.35,
        "weight": 0.91829
      }
    }
  ]
}

json

application/json

Trades

GET

https://api.slamai.dev

/wallet/trades

Returns trades for a specified wallet address as the trader (default) or maker, with optional filtering by token, paired token, pair, side, block range, or timestamp range.

Trades › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

wallet_address

string · required

The wallet address to fetch trades for.

wallet_role

string · enum

Enum values:

trader

maker

Default: trader

token_address

string

The ERC-20 token contract address to fetch trades for.

paired_token_address

string

Filter trades where the specified token was swapped against this paired token address, regardless of pool.

pair

string

The contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for. When present, overrides token_address and paired_token_address.

side

string · enum

Specifies trade side for the given token_address.

Enum values:

buy

sell

all

Default: all

min_usd

number · double

max_usd

number · double

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

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching 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/wallet/trades

curl --request GET \
  --url 'https://api.slamai.dev/wallet/trades?blockchain=base&wallet_address=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 0.065,
  "chain": "base",
  "cursor": {
    "start_block": 31384774,
    "start_log_index": 45
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-18T06:46:35Z",
        "block": 34355124,
        "hash": "0x09c715d8f2c16134119d9cc53a600a09b49d1fa20dcc6cc1a8c02b4a86439d51",
        "method": "swap simple mode",
        "log_index": 582
      },
      "side": "sell",
      "usd": 10726.204254,
      "quote_token": {
        "address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
        "symbol": "VADER",
        "name": "VaderAI by Virtuals",
        "amount": 618854.223280559
      },
      "base_token": {
        "address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
        "symbol": "VIRTUAL",
        "name": "Virtual Protocol",
        "amount": 8899.78611752252
      },
      "price": 0.0141539462344898,
      "pair": {
        "address": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72",
        "name": "VIRTUAL/VADER",
        "labels": "Uniswap V2 Pool"
      },
      "trader": {
        "address": "0x45D964A0E60e45a5144Dc2d2273503B01f83D388"
      },
      "maker": {
        "address": "0x45d964a0e60e45a5144dc2d2273503b01f83d388"
      },
      "sender": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      },
      "recipient": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      }
    }
  ]
}

json

application/json

Trades (DNA)

GET

https://api.slamai.dev

/wallet/trades/dna

Trades (DNA) › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

wallet_address

string · required

The wallet address to fetch trades for.

wallet_role

string · enum

Enum values:

trader

maker

Default: trader

token_address

string

The ERC-20 token contract address to fetch trades for.

paired_token_address

string

Filter trades where the specified token was swapped against this paired token address, regardless of pool.

pair

string

The contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for. When present, overrides token_address and paired_token_address.

side

string · enum

Enum values:

buy

sell

all

Default: all

dna

string

Default: all

min_usd

number · double

max_usd

number · double

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

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−

b−

max_reputation_tier

string · enum

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

Enum values:

a−

b−

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

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

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

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching 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/wallet/trades/dna

curl --request GET \
  --url 'https://api.slamai.dev/wallet/trades/dna?blockchain=base&wallet_address=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 0.065,
  "chain": "base",
  "cursor": {
    "start_block": 31384774,
    "start_log_index": 45
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-18T06:46:35Z",
        "block": 34355124,
        "hash": "0x09c715d8f2c16134119d9cc53a600a09b49d1fa20dcc6cc1a8c02b4a86439d51",
        "method": "swap simple mode",
        "log_index": 582
      },
      "side": "sell",
      "usd": 10726.204254,
      "quote_token": {
        "address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
        "symbol": "VADER",
        "name": "VaderAI by Virtuals",
        "amount": 618854.223280559
      },
      "base_token": {
        "address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
        "symbol": "VIRTUAL",
        "name": "Virtual Protocol",
        "amount": 8899.78611752252
      },
      "price": 0.0141539462344898,
      "pair": {
        "address": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72",
        "name": "VIRTUAL/VADER",
        "labels": "Uniswap V2 Pool"
      },
      "trader": {
        "address": "0x45D964A0E60e45a5144Dc2d2273503B01f83D388"
      },
      "maker": {
        "address": "0x45d964a0e60e45a5144dc2d2273503b01f83d388"
      },
      "sender": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      },
      "recipient": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      }
    }
  ]
}

json

application/json

Transfers

GET

https://api.slamai.dev

/wallet/transfers

Transfers › query Parameters

blockchain

string · enum · required

The blockchain to query

Enum values:

ethereum

base

Default: base

wallet_address

string · required

The wallet address to fetch transfers for.

address

string

Filter transfers where this address is either the sender or the receiver.

token_address

string

The ERC-20 token contract address to fetch transfers for.

direction

string · enum

Transfer direction relative to the address.

Enum values:

sent

received

all

Default: all

num

integer · int32

The maximum number of transfer records to return (1-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). Overrides start_block when provided.

start_block

integer · int32

Block number to start the search from (inclusive).

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 only the SLAM token cost for this query.

Default: false

Transfers › Headers

Authorization

string · required

Bearer token for authentication

Transfers › Responses

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

slam

number · double

The SLAM token cost for this API call.

chain

string

The blockchain network name (e.g., 'base').

object

object[]

List of token transfer records matching the query.

GET/wallet/transfers

curl --request GET \
  --url 'https://api.slamai.dev/wallet/transfers?blockchain=base&wallet_address=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 0.00960899547185145,
  "chain": "base",
  "cursor": {
    "start_block": 33297128,
    "start_log_index": 995
  },
  "transfers": [
    {
      "transaction": {
        "utc": "2025-07-24T19:01:47Z",
        "block": 33297180,
        "hash": "0xec1765d57f51a6a7274c33991b42e1c1bff6f760462c0409b13a2632a8ed4934",
        "method": "execute",
        "log_index": 403
      },
      "token": {
        "address": "0x98d0baa52b2d063e780de12f615f963fe8537553",
        "symbol": "KAITO",
        "name": "KAITO"
      },
      "from": {
        "address": "0x6a0a87ec975DF3D2A4d6159Db55B034D4313ED66"
      },
      "to": {
        "address": "0x37bb450b17721c6720040a150029e504766e9777",
        "name": "WETH/KAITO",
        "labels": "Uniswap V3 Pool"
      },
      "amount": {
        "raw": 293120070211072300,
        "decimals": 0.2931200702110723
      }
    }
  ]
}

json

application/json

Transfers (DNA)

GET

https://api.slamai.dev

/wallet/transfers/dna

Transfers (DNA) › query Parameters

blockchain

string · enum · required

The blockchain network to query.

Enum values:

ethereum

base

Default: base

wallet_address

string · required

The wallet address to fetch transfers for.

address

string

Optional filter to only include transfers involving this address

token_address

string

Optional filter transfers for this ERC-20 token contract address.

direction

string · enum

Transfer direction relative to the address.

Enum values:

sent

received

all

Default: all

num

integer · int32

Max number of transfer records to return (max 100)

Default: 25

order

string · enum

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

Enum values:

asc

desc

Default: desc

start_timestamp

string · date-time

Start from this UTC timestamp (overrides start_block)

start_block

integer · int32

Block number to start from (inclusive)

start_log_index

integer · int32

Log index within the block to resume pagination

estimate_cost

boolean

When true, returns only the SLAM cost without performing the query

Default: false

Transfers (DNA) › Headers

Authorization

string · required

Bearer token for authentication

Transfers (DNA) › Responses

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

slam

number · double

SLAM token cost for this API call

chain

string

Blockchain network name (e.g., 'base')

object

object[]

List of enriched token transfers with WalletDNA

GET/wallet/transfers/dna

curl --request GET \
  --url 'https://api.slamai.dev/wallet/transfers/dna?blockchain=base&wallet_address=%3Cstring%3E' \
  --header 'Authorization: Bearer <TOKEN>'

shell

Example Responses

{
  "slam": 0.0096,
  "chain": "base",
  "cursor": {
    "start_block": 33297128,
    "start_log_index": 995
  },
  "transfers": [
    {
      "transaction": {
        "utc": "2025-07-24T19:01:47Z",
        "block": 33297180,
        "hash": "0xec17...",
        "method": "execute",
        "log_index": 403
      },
      "token": {
        "address": "0x98d0...",
        "symbol": "KAITO",
        "name": "KAITO",
        "usd": 0.45,
        "fdv": 40000000
      },
      "from": {
        "address": "0x6a0a...",
        "balance": {
          "decimals": 1.23,
          "usd": 0.56,
          "supply_share": 0.0001
        },
        "mass": {
          "tier": "Fish",
          "raw": 100
        }
      },
      "to": {
        "address": "0x37bb...",
        "name": "WETH/KAITO",
        "labels": "Uniswap V3 Pool",
        "balance": {
          "decimals": 99.1,
          "usd": 50.3,
          "supply_share": 0.0501
        },
        "mass": {
          "tier": "Whale",
          "raw": 1500
        }
      },
      "amount": {
        "raw": 293120000000000000,
        "decimals": 0.2931,
        "usd": 0.12
      }
    }
  ]
}

json

application/json

Chain Pair