SLAMai

🪙 Token

Endpoint:https://slamai.dev

Price

GET

https://slamai.dev

/token/price

Returns current token prices with FDV, liquidity, and 24h price change, quoted in USD, ETH, or BTC.

Rules

Provide either symbols or addresses, not both.
Max 30 entries for either parameter (pipe-delimited).
quote_symbol must be one of: USD, ETH, BTC.

Price › query Parameters

blockchainstring · enum · required
The blockchain network to query.
Enum values:
ethereum
base
Default: base
symbolsstring
Pipe-delimited list of token symbols to query (e.g., SWARM|VADER). Cannot be used with 'addresses'. Max 30 symbols.
addressesstring
Pipe-delimited list of token contract addresses (e.g., 0xabc...|0xdef...). Cannot be used with 'symbols'. Max 30 addresses.
quote_symbolstring
Quote token or currency to return prices in. Allowed: USD (default), ETH, BTC.
Default: USD
estimate_costboolean
When true, only returns the SLAM token cost for this request. Does not include token price data.

Price › Headers

Authorizationstring · required
Bearer token for authentication

Price › Responses

slamnumber · double · required
The SLAM token cost for this API call.
chainstring · minLength: 1 · required
The blockchain network name (e.g., 'base').
blockinteger · int32 · required
The block number for this price snapshot.
utcstring · minLength: 1 · required
UTC timestamp of this data (ISO 8601).
quotestring · minLength: 1 · required
Quote token or currency (USD, ETH, BTC).

tokensobject[]
List of token price data.

slamnumber · double

Price - History

GET

https://slamai.dev

/token/price/history

Retrieves token prices, FDV, and liquidity at any block or timestamp, including percentage change for specified lookback periods.

Price - History › query Parameters

blockchainstring · enum · required
The blockchain network to query.
Enum values:
ethereum
base
Default: base
symbolsstring
Pipe-delimited token symbols. Max: 30. E.g. SWARM|BILLY
addressesstring
Pipe-delimited token addresses. Max: 30.
quote_symbolstring
Quote token: USD (default), ETH, or BTC
at_block_numberinteger · int32
Block number to retrieve price snapshot at
at_timestampstring · date-time
Datetime (UTC) to retrieve price snapshot at
lookback_minutesstring
Pipe-delimited list of minute values for % change. Max: 30. E.g. 60|1440
estimate_costboolean
If true, returns only the SLAM token cost
Default: false

Price - History › Headers

Authorizationstring · required
Bearer token for authentication

Price - History › Responses

slamnumber · double · required
The SLAM token cost for this API call.
chainstring · minLength: 1 · required
The blockchain network name (e.g., 'base').
blockinteger · int32 · required
The block number for this price snapshot.
utcstring · minLength: 1 · required
UTC timestamp of this data (ISO 8601).
quotestring · minLength: 1 · required
Quote token or currency (USD, ETH, BTC).

tokensobject[]
List of token price data.

Price (Exotic)

GET

https://slamai.dev

/token/price/exotic

Retrieves token price details including FDV, liquidity, and 24-hour change, quoted in any ERC20 or major blockchain token.

Price (Exotic) › query Parameters

blockchainstring · enum · required
The blockchain network to query.
Enum values:
ethereum
base
Default: base
symbolsstring
A pipe-delimited list of token symbols to query. When multiple tokens have the same symbol, the system chooses the most active token with that symbol over the last 24 hours. Example: SWARM|VADER Maximum: 30 symbols
addressesstring
Pipe-delimited token addresses. Max: 30. E.g. 0x123...|0x456...
quote_symbolstring
The quote token to use for price output. Any ERC20 token symbol and many major tokens on other blockchains are supported. When multiple tokens have the same symbol, the system chooses the most active token with that symbol over the last 24 hours.Example: BRETT
quote_addressstring
The contract address of the token to use for price output. Any ERC20 token address is supported.
estimate_costboolean
Return only SLAM token cost for this query
Default: false

Price (Exotic) › Headers

Authorizationstring · required
Bearer token for authentication

Price (Exotic) › Responses

slamnumber · double · required
The SLAM token cost for this API call.
chainstring · minLength: 1 · required
The blockchain network name (e.g., 'base').
blockinteger · int32 · required
The block number for this price snapshot.
utcstring · minLength: 1 · required
UTC timestamp of this data (ISO 8601).
quotestring · minLength: 1 · required
Quote token or currency (USD, ETH, BTC).

tokensobject[]
List of token price data.

slamnumber · double

Price (Exotic) - History

GET

https://slamai.dev

/token/price/exotic/history

Returns token prices, FDV, liquidity and lookback percentage change quoted in any token at a historical block or timestamp.

Price (Exotic) - History › query Parameters

blockchainstring · enum · required
The blockchain to query
Enum values:
ethereum
base
Default: base
symbolsstring
Pipe-delimited list of token symbols (max 30) e.g. SWARM|BILLY
addressesstring
Pipe-delimited list of token addresses (max 30)
quote_symbolstring
The quote token to use for price output. Any ERC20 token symbol and many major tokens on other blockchains are supported. When multiple tokens have the same symbol, the system chooses the most active token with that symbol over the last 24 hours. Example: BRETT
quote_addressstring
The contract address of the token to use for price output. Any ERC20 token address is supported.
at_block_numberinteger · int32
Historical prices will be calculated as of this block number. Lookback periods are also measured from this point in time. Overrides at_timestamp when present.
at_timestampstring · date-time
Historical prices will be calculated as of this timestamp. Lookback periods are also measured from this point in time.
lookback_minutesstring
A pipe-delimited list of numbers, represented as minutes, to calculate previous prices and % change for.Example: 60|360|1440|10080 Maximum: 30 lookback periods
estimate_costboolean
If true, returns only the SLAM token cost

Price (Exotic) - History › Headers

Authorizationstring · required
Bearer token for authentication

Price (Exotic) - History › Responses

slamnumber · double · required
The SLAM token cost for this API call.
chainstring · minLength: 1 · required
The blockchain network name (e.g., 'base').
blockinteger · int32 · required
The block number for this price snapshot.
utcstring · minLength: 1 · required
UTC timestamp of this data (ISO 8601).
quotestring · minLength: 1 · required
Quote token or currency (USD, ETH, BTC).

tokensobject[]
List of token price data.

slamnumber · double

Trades

GET

https://slamai.dev

/token/trades

Returns trades for a specified token address, with optional filtering by side, trader, maker, paired token, block range, or timestamp range.

Trades › query Parameters

blockchainstring · enum · required
The blockchain network to query.
Enum values:
ethereum
base
Default: base
token_addressstring · required
The ERC-20 token contract address 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.
paired_token_addressstring
Filter trades where the specified token was swapped against this paired token address, regardless of pool.
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

/token/trades/dna

This endpoint retrieves token trade data 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
token_addressstring · required
The ERC-20 token contract address 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.
paired_token_addressstring
Filter trades where the specified token was swapped against this paired token address, regardless of pool.
sidestring · enum
Specifies trade side for the given token_address.
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

/token/transfers

Returns token transfers for a specific token address, with optional filters by participant address, direction, block/timestamp range, and pagination.

Transfers › query Parameters

blockchainstring · enum · required
The blockchain to query
Enum values:
ethereum
base
Default: base
token_addressstring · required
The ERC-20 token contract address to fetch transfers for (required).
addressstring
Filter transfers where this address is either the sender or the receiver.
directionstring · enum
Specifies transfer direction relative to 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

/token/transfers/dna

Returns token transfer records for a given token 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
token_addressstring · required
ERC-20 token contract address to fetch transfers for.
addressstring
Optional filter to only include transfers involving this address
directionstring · enum
Specifies transfer direction relative to address.
Enum values:
sent
received
all
Default: all
numinteger · int32
Max number of transfer records to return (max 100)
Default: 10
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). 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 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

Holder (Reputation)

GET

https://slamai.dev

/token/holder/reputation

Returns reputation scores for one or more wallets holding a token, at the current or historical block/timestamp.

Holder (Reputation) › query Parameters

blockchainstring · enum · required
The blockchain network to query.
Enum values:
ethereum
base
Default: base
token_addressstring
The contract address of the token
token_symbolstring
The token symbol (used if token_address is not supplied)
wallet_addressesstring
Pipe-delimited list of wallet addresses. Max: 100
at_block_numberinteger · int32
Block number at which to calculate reputation. If omitted, the latest block is used.
at_timestampstring · date-time
UTC timestamp for calculating reputation. If both at_block_number and at_timestamp are supplied, at_block_number takes precedence.
estimate_costboolean
If true, only the SLAM token cost is returned
Default: false

Holder (Reputation) › Headers

Authorizationstring · required
Bearer token for authentication

Holder (Reputation) › Responses

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
holdersobject[]
List of holder reputation records matching the query

⛓️ Chain