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

Example

PreviousSTAKE $MZRNextFEES

Last updated