SLAMai

Pair

Endpoint:https://slamai.dev

Trades

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

  • blockchainstring · enum · required

    The blockchain network to query.

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

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

  • trader_addressstring

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

  • maker_addressstring

    Filter trades where this address initiated the swap transaction.

  • 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
  • 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
/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

  • blockchainstring · enum · required

    The blockchain network to query.

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

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

  • trader_addressstring

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

  • maker_addressstring

    Filter trades where this address initiated the swap transaction.

  • 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
Wallet