⚙️API
Manage your bots using Mizar SDK
To use the Mizar API, visit https://app.mizar.com/dex/api to create your API keys. These keys are required to authenticate and connect to Mizar from external software.
Update Token List
POST https://api.mizar.com/api/v1/dex/volatility-bot/update-token-list
Headers
mizar-api-key
string
your mizar api key
Request Body
bot_id
string
you can find the bot id here https://app.mizar.com/dex/bots/volatility-bot
addresses
string[]
The tokena addresses you want to whitelist
Example
import httpx
# Replace these with your actual values
API_KEY = "your_api_key_here"
BOT_ID = "your_bot_id_here" (you can find it here https://app.mizar.com/dex/bots/volatility-bot)
ADDRESSES = ["tokenAddress1", "tokenAddress2"]
url = "https://api.mizar.com/api/v1/dex/volatility-bot/update-token-list"
headers = {
"mizar-api-key": API_KEY
}
payload = {
"bot_id": BOT_ID,
"addresses": ADDRESSES
}
response = httpx.post(url, headers=headers, json=payload)
if response.status_code == 200:
print("Token list updated successfully:", response.json())
else:
print(f"Failed to update token list: {response.status_code}, {response.text}")
Fetch Hot Tokens
GET https://api.mizar.com/api/v1/dex/{chain}/{period}/hot-tokens
Headers
mizar-api-key
string
your mizar api key
Query Params
sort
string
Sorting key. Check allowed sort keys
address
string
Single token contract address.
addresses
string[]
List of token addresses.
is_alpha_call
boolean
If true
, only include Alpha Call tokens.
is_top_ten_alpha
boolean
If true
, only include Top 10 Alpha tokens.
market_cap__ge
number
Minimum Market Cap (in USD).
market_cap__le
number
Maximum Market Cap (in USD).
volume__ge
number
Minimum Trading Volume (in USD).
volume__le
number
Maximum Trading Volume (in USD).
liquidity__ge
number
Minimum Liquidity (in USD).
liquidity__le
number
Maximum Liquidity (in USD).
token_age__ge
number
Minimum Token Age (minutes).
token_age__le
number
Maximum Token Age (minutes).
volatility_index__ge
number
Minimum Volatility Index (as decimal, e.g. 0.1
= 10%).
volatility_index__le
number
Maximum Volatility Index (as decimal, e.g. 0.1
= 10%).
smart_buy_volume__ge
number
Minimum Smart Buy Volume (in USD).
smart_buy_volume__le
number
Maximum Smart Buy Volume (in USD).
smart_buy_wallets__ge
number
Minimum Smart Buy Wallets.
smart_buy_wallets__le
number
Maximum Smart Buy Wallets.
smart_sell_volume__ge
number
Minimum Smart Sell Volume (in USD).
smart_sell_volume__le
number
Maximum Smart Sell Volume (in USD).
smart_money_inflow__ge
number
Minimum Smart Money Inflow (in USD).
smart_money_inflow__le
number
Maximum Smart Money Inflow (in USD).
price_change__ge
number
Minimum Price Change (as decimal, e.g. 0.1
= 10%).
price_change__le
number
Maximum Price Change (as decimal, e.g. 0.1
= 10%).
rug_addicted_buy__lt
number
Max % of Rug-Addicted Wallets (as decimal, e.g. 0.1
= 10%).
scammer_buy__lt
number
Max % of Scammer Wallets (as decimal, e.g. 0.1
= 10%).
suspicious_buy__lt
number
Max % of Suspicious Wallets (as decimal, e.g. 0.1
= 10%).
fresh_buy__lt
number
Max % of Fresh Wallets (as decimal, e.g. 0.1
= 10%).
🔄 Supported Chains
eth
(Ethereum)sol
(Solana)base
(BASE)bsc
(BNB Chain)
🔄 Supported Protocols (protocols
)
RAYDIUM_AMM
RAYDIUM_CP
RAYDIUM_CLMM
RAYDIUM_LAUNCHLAB
LETSBONKDOTFUN
PUMP_FUN
PUMP_SWAP
METEORA_DYN
METEORA_DLMM
MOONSHOT
ORCA_WHIRLPOOL
UNISWAP_V2
UNISWAP_V3
PANCAKESWAP_V2
PANCAKESWAP_V3
SUSHISWAP_V2
🕒 Periods (period
)
5m
5 minutes
15m
15 minutes
30m
30 minutes
1h
1 hour
6h
6 hours
24h
24 hours
📤 Response Example (json)
[
{
"quote": "BNB",
"base": "1111",
"status": "NOT_SNIPEABLE",
"chain": "bsc",
"dex": "PANCAKESWAP_V2",
"tokenAddress": "0xc0f3A85a1524671A588d419aa3f4dcF358c74444",
"poolId": "1a434fb8-b6d4-476d-bce1-cd4468b80689",
"poolAddress": "0x77Cc1b5575e0dE69F57ED5eE34F11b5a973BAe54",
"poolCreatedAt": "2025-10-03T03:58:51+00:00",
"totalBuyTop": 346,
"totalSellsTop": 330,
"totalBuy": 5405,
"totalBuyTxs": 12958,
"buyVolumeTop": "526967.461772597537101329",
"buyVolume": "3778791.990657320778558962",
"totalSells": 4184,
"totalSellTxs": 10444,
"sellVolume": "3760959.21530873660590708",
"sellVolumeTop": "604975.041144841053162368",
"volume": "7539751.205966057384466042",
"topSniperBuy": 210,
"topEarlyApeBuy": 86,
"topTraderBuy": 51,
"topSniperSell": 208,
"topEarlyApeSell": 71,
"topTraderSell": 52,
"currentPrice": "0.00164750163824968973",
"startPeriodPrice": "0.00014027563052730722",
"currentLiquidity": "193774.17863113535",
"currentMarketCap": "1647501.6382496897",
"priceChange": "10.74474591243397312354",
"weightedAverageBuyPrice": "0.00073126476538525450559214865834010729",
"weightedAverageSellPrice": "0.00073663274416974629288757466776246927",
"weightedAverageBuyPriceTop": "0.00064618879009604587298372306019630819",
"weightedAverageSellPriceTop": "0.00057374717625892402307858266719799594",
"netInflowTop": "-78007.579372243516061039",
"netInflow": "17832.775348584172651882",
"suspiciousBuy": 2,
"suspiciousSell": 4,
"freshSell": 637,
"freshBuy": 1051,
"scammerBuy": 2,
"scammerSell": 3,
"rugAddictedBuy": 104,
"rugAddictedSell": 80,
"totalMakers": 5713,
"topMakers": 346,
"buyTxsTop": 1119,
"sellTxsTop": 1087,
"volatilityIndex": "0.5592319966546653",
"hasIcon": false,
"sites": []
}
]
Example
import httpx
# Replace these with your actual values
API_KEY = "your_api_key_here"
PERIOD = "5m"
CHAIN = "sol"
url = f"https://api.mizar.com/api/v1/dex/{CHAIN}/{PERIOD}/hot-tokens"
headers = {
"mizar-api-key": API_KEY
}
response = httpx.post(url, headers=headers, json=payload)
if response.status_code == 200:
print("Token list updated successfully:", response.json())
else:
print(f"Failed to update token list: {response.status_code}, {response.text}")
Last updated