SLAMai

Wallet

Endpoint:https://slamai.dev

Reputation

GET
https://slamai.dev
/wallet/reputation

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

Reputation › query Parameters

  • blockchainstring · enum · required

    The blockchain network to query.

    Enum values:
    ethereum
    base
    Default: base
  • addressesstring

    Pipe-delimited list of wallet addresses. Max: 10

  • at_block_numberinteger · int32

    Block number at which to calculate reputation

  • at_timestampstring · date-time

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

  • estimate_costboolean

    If true, only the SLAM token cost is returned

Reputation › Headers

  • Authorizationstring · required

    Bearer token for authentication

Reputation › Responses

OK

  • slamnumber · double

    SLAM token cost for this API call

  • chainstring

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

  • blockinteger · int32

    Block number for the reputation snapshot

  • utcstring

    UTC timestamp of the snapshot in ISO 8601 format

  • walletsobject[]

    List of wallet reputation records

Reputation (Full)

GET
https://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

  • blockchainstring · enum · required

    The blockchain network to query.

    Enum values:
    ethereum
    base
    Default: base
  • addressesstring

    Pipe-delimited list of wallet addresses. Max: 10

  • at_block_numberinteger · int32

    Block number to calculate reputation at

  • at_timestampstring · date-time

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

  • estimate_costboolean

    If true, only the SLAM token cost is returned

    Default: false

Reputation (Full) › Headers

  • Authorizationstring · required

    Bearer token for authentication

Reputation (Full) › Responses

  • slamnumber · double

    SLAM token cost for this API call

  • chainstring

    Blockchain network name

  • blockinteger · int32

    Block number used for reputation snapshot

  • utcstring

    UTC ISO 8601 timestamp of snapshot

  • walletsobject[]

    List of wallets and their full reputation profiles

  • slamnumber · double

Reputation (Holder)

GET
https://slamai.dev
/wallet/holder/reputation

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

Reputation (Holder) › query Parameters

  • blockchainstring · enum · required

    The blockchain network to query.

    Enum values:
    ethereum
    base
    Default: base
  • wallet_addressstring · required

    Address of the wallet to query

  • token_addressesstring

    Pipe-delimited list of token addresses to query

  • token_symbolsstring

    Pipe-delimited list of token symbols to query

  • at_block_numberinteger · int32

    Block number to calculate reputation at

  • at_timestampstring · date-time

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

  • estimate_costboolean

    If true, only the SLAM token cost is returned

    Default: false

Reputation (Holder) › Headers

  • Authorizationstring · required

    Bearer token for authentication

Reputation (Holder) › Responses

  • slamnumber · double

    SLAM token cost for this API call

  • chainstring

    Blockchain network name

  • blockinteger · int32

    Block number for the reputation snapshot

  • utcstring

    UTC timestamp in ISO 8601 format

  • holdersobject[]

    List of token-specific reputation records for the wallet

  • slamnumber · double

Trades

GET
https://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

  • blockchainstring · enum · required

    The blockchain network to query.

    Enum values:
    ethereum
    base
    Default: base
  • wallet_addressstring · required

    The wallet address to fetch trades for.

  • wallet_rolestring

    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.

    Default: trader
  • token_addressstring

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

  • paired_token_addressstring

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

  • pairstring

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

  • sidestring · enum

    Specifies trade side for the given token_address.

    Enum values:
    buy
    sell
    all
    Default: all
  • min_usdnumber · 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_usdnumber · 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.

  • numinteger · int32

    The maximum number of records to return.

    Default: 25
  • orderstring

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

    Default: desc
  • start_timestampstring · date-time

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

  • start_blockinteger · 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_indexinteger · int32

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

  • estimate_costboolean

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

Trades › Headers

  • Authorizationstring · required

    Bearer token for authentication

Trades › Responses

  • slamnumber · double

    The SLAM token cost for this API call.

  • chainstring

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

  • cursorobject
  • tradesobject[]

    List of token trade records matching the query.

  • slamnumber · double

Trades (DNA)

GET
https://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

  • blockchainstring · enum · required

    The blockchain network to query.

    Enum values:
    ethereum
    base
    Default: base
  • wallet_addressstring · required

    The wallet address to fetch trades for.

  • wallet_rolestring · enum · required

    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_addressstring

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

  • paired_token_addressstring

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

  • pairstring

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

  • sidestring · 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
  • dnastring

    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_usdnumber · 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_usdnumber · 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_iqnumber · 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_iqnumber · 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_intelligencestring · enum

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

    Enum values:
    idiot
    dumb
    below avg
    avg
    avg++
    gifted
    gifted++
    genius
  • max_intelligencestring · enum

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

    Enum values:
    idiot
    dumb
    below avg
    avg
    avg++
    gifted
    gifted++
    genius
  • min_reputationnumber · double

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

  • max_reputationnumber · double

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

  • min_reputation_tierstring · enum

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

    Enum values:
    a+
    a
    a−
    b+
    b
    b−
    c+
    c
  • max_reputation_tierstring · enum

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

    Enum values:
    a+
    a
    a−
    b+
    b
    b−
    c+
    c
  • min_massnumber · double

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

  • max_massnumber · double

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

  • min_mass_tierstring · enum

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

    Enum values:
    ghost
    dust
    plankton
    shrimp
    minnow
    fish
    dolphin
    orca
  • max_mass_tierstring · enum

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

    Enum values:
    ghost
    dust
    plankton
    shrimp
    minnow
    fish
    dolphin
    orca
  • min_epochnumber · double

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

  • max_epochnumber · double

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

  • min_epoch_tierstring · 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_tierstring · 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_presencenumber · double

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

  • max_maker_presencenumber · 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_tierstring · 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_tierstring · 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_flownumber · double

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

  • max_flownumber · double

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

  • min_flow_tierstring · enum

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

    Enum values:
    dry
    drip
    trickle
    stream
    current
    flood
    torrent
    tsunami
  • max_flow_tierstring · enum

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

    Enum values:
    dry
    drip
    trickle
    stream
    current
    flood
    torrent
    tsunami
  • min_buy_flownumber · double

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

  • max_buy_flownumber · 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_tierstring · 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_tierstring · 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_flownumber · double

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

  • max_sell_flownumber · 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_tierstring · 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_tierstring · enum

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

    Enum values:
    dry
    drip
    trickle
    stream
    current
    flood
    torrent
    tsunami
  • numinteger · int32

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

    Default: 25
  • orderstring · enum

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

    Enum values:
    asc
    desc
    Default: desc
  • start_timestampstring · date-time

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

  • start_blockinteger · 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_indexinteger · int32

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

  • estimate_costboolean

    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

  • Authorizationstring · required

    Bearer token for authentication

Trades (DNA) › Responses

  • slamnumber · double

    The SLAM token cost for this API call.

  • chainstring

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

  • cursorobject
  • tradesobject[]

    List of token trade records matching the query.

  • slamnumber · double

Transfers

GET
https://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

  • blockchainstring · enum · required

    The blockchain to query

    Enum values:
    ethereum
    base
    Default: base
  • wallet_addressstring

    The wallet address to fetch transfers for. (Required)

  • addressstring

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

  • token_addressstring

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

  • directionstring · enum

    Transfer direction relative to the address.

    Enum values:
    sent
    received
    all
    Default: all
  • numinteger · int32

    The maximum number of transfer records to return (1-1000).

    Default: 25
  • orderstring · enum

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

    Enum values:
    asc
    desc
    Default: desc
  • start_timestampstring · date-time

    Start searching from this UTC timestamp (inclusive). Overrides start_block when provided.

  • start_blockinteger · int32

    Block number to start the search from (inclusive).

  • start_log_indexinteger · int32

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

  • estimate_costboolean

    When true, returns only the SLAM token cost for this query.

    Default: false

Transfers › Headers

  • Authorizationstring · required

    Bearer token for authentication

Transfers › Responses

  • slamnumber · double

    The SLAM token cost for this API call.

  • chainstring

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

  • cursorobject
  • transfersobject[]

    List of token transfer records matching the query.

  • slamnumber · double

Transfers (DNA)

GET
https://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

  • blockchainstring · enum · required

    The blockchain network to query.

    Enum values:
    ethereum
    base
    Default: base
  • wallet_addressstring · required

    The wallet address to fetch transfers for.

  • addressstring

    Optional filter to only include transfers involving this address

  • token_addressstring

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

  • directionstring · enum

    Transfer direction relative to the address.

    Enum values:
    sent
    received
    all
    Default: all
  • numinteger · int32

    Max number of transfer records to return (max 100)

    Default: 25
  • orderstring · enum

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

    Enum values:
    asc
    desc
    Default: desc
  • start_timestampstring · date-time

    Start from this UTC timestamp (overrides start_block)

  • start_blockinteger · int32

    Block number to start from (inclusive)

  • start_log_indexinteger · int32

    Log index within the block to resume pagination

  • estimate_costboolean

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

    Default: false

Transfers (DNA) › Headers

  • Authorizationstring · required

    Bearer token for authentication

Transfers (DNA) › Responses

  • slamnumber · double

    SLAM token cost for this API call

  • chainstring

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

  • cursorobject
  • transfersobject[]

    List of enriched token transfers with WalletDNA

  • slamnumber · double
⛓️ ChainPair