⚙️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

Name
Type
Description

mizar-api-key

string

your mizar api key

Request Body

Name
Type
Description

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

Name
type
Description

mizar-api-key

string

your mizar api key

Query Params

Name
Type
Description

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)

Value
Meaning

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