Skip to main content
Glama
Sign In
aster-info-mcp

aster-info-mcp

by kukapay
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Aster Info MCP

An MCP server that provides structured access to Aster DEX market data—covering candlesticks, order books, trades, and funding rates.

GitHub License Python Version Status

Features

  • 13 Tools: Access a variety of Aster Finance Futures API endpoints, including:

    • Candlestick data (get_kline, get_index_price_kline, get_mark_price_kline)

    • Price and ticker data (get_latest_price, get_price_change_statistics_24h, get_order_book_ticker)

    • Order book and trade data (get_order_book, get_recent_trades, get_historical_trades, get_aggregated_trades)

    • Funding and index data (get_premium_index, get_funding_rate_history)

  • Markdown Output: All tools return data as formatted Markdown tables for easy readability and integration.

  • Robust Error Handling: Handles HTTP errors (e.g., 400, 429) and data processing issues with clear exceptions.

Related MCP server: AsterDex MCP Server

Installation

Prerequisites

  • Python 3.10 or higher

  • uv (recommended package manager)

Steps

  1. Clone the Repository:

    git clone https://github.com/kukapay/aster-info-mcp.git
cd aster-info-mcp

  2. Install Dependencies:

    uv sync

  3. Installing to Claude Desktop:

    Install the server as a Claude Desktop application:

    uv run mcp install main.py --name "Aster Info"

    Configuration file as a reference:

    {
   "mcpServers": {
       "Aster Info": {
           "command": "uv",
           "args": [ "--directory", "/path/to/aster-info-mcp", "run", "main.py" ]
       }
   }
}

    Replace /path/to/aster-info-mcp with your actual installation path.

Usage

Available Tools

Tool Name

Description

Parameters

get_kline

Fetch candlestick data for a symbol.

symbol, interval, startTime (opt), endTime (opt), limit (opt)

get_index_price_kline

Fetch index price candlestick data for a pair.

pair, interval, startTime (opt), endTime (opt), limit (opt)

get_mark_price_kline

Fetch mark price candlestick data for a symbol.

symbol, interval, startTime (opt), endTime (opt), limit (opt)

get_premium_index

Fetch premium index data (mark price, funding rate).

symbol (opt)

get_funding_rate_history

Fetch historical funding rate data for a symbol.

symbol, startTime (opt), endTime (opt), limit (opt)

get_price_change_statistics_24h

Fetch 24-hour price change statistics.

symbol (opt)

get_latest_price

Fetch the latest price for a symbol or all symbols.

symbol (opt)

get_order_book_ticker

Fetch order book ticker data (best bid/ask prices and quantities).

symbol (opt)

get_order_book

Fetch order book data (bids and asks) for a symbol.

symbol, limit (opt)

get_recent_trades

Fetch recent trades for a symbol.

symbol, limit (opt)

get_historical_trades

Fetch historical trades for a symbol.

symbol, limit (opt), fromId (opt)

get_aggregated_trades

Fetch aggregated trades for a symbol.

symbol, fromId (opt), startTime (opt), endTime (opt), limit (opt)

Notes:

  • All tools return data as Markdown tables.

  • Parameters marked (opt) are optional.

  • Timestamps are in milliseconds (Unix epoch); outputs are converted to readable datetime format.

  • Numeric fields are rounded to 8 decimal places (except priceChangePercent, rounded to 2).

Examples

Below are examples for each of the 13 tools.

Example: Fetching Candlestick Data (get_kline)

Prompt: 

Get me the latest 1-minute candlestick data for ETHUSDT, limited to the last 2 entries.

Expected response (Markdown table):

| open_time           | open      | high      | low       | close     |
|---------------------|-----------|-----------|-----------|-----------|
| 2025-06-18 22:42:00 | 3500.1234 | 3510.5678 | 3490.4321 | 3505.6789 |
| 2025-06-18 22:43:00 | 3505.6789 | 3520.1234 | 3500.8765 | 3510.2345 |

Example: Fetching Index Price Candlestick Data (get_index_price_kline)

Prompt: 

Show me the 1-hour index price candlestick data for BTCUSD for the last 2 hours.

Expected response (Markdown table):

| open_time           | open       | high       | low        | close      |
|---------------------|------------|------------|------------|------------|
| 2025-06-18 21:00:00 | 65000.1234 | 65200.5678 | 64900.4321 | 65100.6789 |
| 2025-06-18 22:00:00 | 65100.6789 | 65300.1234 | 65050.8765 | 65210.2345 |

Example: Fetching Mark Price Candlestick Data (get_mark_price_kline)

Prompt: 

Give me the 1-minute mark price candlestick data for BTCUSDT, limited to the last 2 entries.

Expected response (Markdown table):

| open_time           | open       | high       | low        | close      |
|---------------------|------------|------------|------------|------------|
| 2025-06-18 22:42:00 | 65010.1234 | 65020.5678 | 65000.4321 | 65015.6789 |
| 2025-06-18 22:43:00 | 65015.6789 | 65030.1234 | 65010.8765 | 65025.2345 |

Example: Fetching Premium Index Data (get_premium_index)

Prompt: 

Show me the premium index data for ETHUSDT.

Expected response (Markdown table):

| symbol  | markPrice  | indexPrice | lastFundingRate | nextFundingTime     |
|---------|------------|------------|-----------------|---------------------|
| ETHUSDT | 3505.1234  | 3500.5678  | 0.0001          | 2025-06-19 00:00:00 |

Example: Fetching Funding Rate History (get_funding_rate_history)

Prompt: 

Get the funding rate history for BTCUSDT, limited to the last 2 records.

Expected response (Markdown table):

| symbol  | fundingTime         | fundingRate |
|---------|---------------------|-------------|
| BTCUSDT | 2025-06-18 16:00:00 | 0.00012     |
| BTCUSDT | 2025-06-18 20:00:00 | 0.00015     |

Example: Fetching 24-Hour Price Change Statistics (get_price_change_statistics_24h)

Prompt: 

Show me the 24-hour price change statistics for ETHUSDT.

Expected response (Markdown table):

| symbol  | priceChange | priceChangePercent | lastPrice  | volume     |
|---------|-------------|--------------------|------------|------------|
| ETHUSDT | 50.1234     | 1.45               | 3505.6789  | 1000.4321  |

Example: Fetching Latest Price (get_latest_price)

Prompt: 

Show me the current price of BTCUSDT.

Expected response (Markdown table):

| symbol  | price      |
|---------|------------|
| BTCUSDT | 65000.1234 |

Example: Fetching Order Book Ticker Data (get_order_book_ticker)

Prompt*: 

Get the best bid and ask prices for ETHUSDT.

Expected response (Markdown table):

| symbol  | bidPrice  | bidQty    | askPrice  | askQty    |
|---------|-----------|-----------|-----------|-----------|
| ETHUSDT | 3500.1234 | 10.5678   | 3505.6789 | 15.4321   |

Example: Fetching Order Book Data (get_order_book)

Prompt: 

Show me the order book for BTCUSDT with 2 entries per side.

Expected response (Markdown table):

| side | price      | quantity   |
|------|------------|------------|
| bid  | 65000.1234 | 0.5678     |
| bid  | 64995.6789 | 0.4321     |
| ask  | 65005.1234 | 0.8765     |
| ask  | 65010.6789 | 0.2345     |

Example: Fetching Recent Trades (get_recent_trades)

Prompt: 

Get the most recent trades for ETHUSDT, limited to 2 trades.

Expected response (Markdown table):

| tradeId | price     | qty       | quoteQty  | time                | isBuyerMaker |
|---------|-----------|-----------|-----------|---------------------|--------------|
| 123456  | 3505.6789 | 1.2345    | 4321.1234 | 2025-06-18 22:43:00 | True         |
| 123457  | 3500.1234 | 0.8765    | 3067.5678 | 2025-06-18 22:42:00 | False        |

Example: Fetching Historical Trades (get_historical_trades)

Prompt: 

Show me historical trades for BTCUSDT starting from trade ID 1000, limited to 2 trades.

Expected response (Markdown table):

| tradeId | price      | qty       | quoteQty   | time                | isBuyerMaker |
|---------|------------|-----------|------------|---------------------|--------------|
| 1000    | 65000.1234 | 0.1234    | 8025.6789  | 2025-06-18 20:00:00 | True         |
| 1001    | 64995.6789 | 0.2345    | 15245.1234 | 2025-06-18 20:01:00 | False        |

Example: Fetching Aggregated Trades (get_aggregated_trades)

Prompt: 

Get aggregated trades for ETHUSDT starting from aggregated trade ID 500, limited to 2 trades.

Expected response (Markdown table):

| aggTradeId | price     | qty       | firstTradeId | lastTradeId | time                | isBuyerMaker |
|------------|-----------|-----------|--------------|-------------|---------------------|--------------|
| 500        | 3500.1234 | 5.6789    | 1000         | 1005        | 2025-06-18 22:40:00 | True         |
| 501        | 3505.6789 | 3.4321    | 1006         | 1010        | 2025-06-18 22:41:00 | False        |

License

This project is licensed under the MIT License.

Available Tools

11 tools
get_aggregated_tradesA
Fetch aggregated trades data from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (str): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
    fromId (Optional[int]): Aggregated trade ID to start from. If None, uses time-based query or most recent trades.
    startTime (Optional[int]): Start time in milliseconds since Unix epoch. If None, defaults to API behavior.
    endTime (Optional[int]): End time in milliseconds since Unix epoch. If None, defaults to API behavior.
    limit (Optional[int]): Number of aggregated trades to return (1 to 1000). If None, defaults to 500.

Returns:
    str: Markdown table containing aggTradeId, price, qty, firstTradeId, lastTradeId, time, and isBuyerMaker.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol (required), fromId, startTime, endTime, +1 more.

get_funding_rate_historyA
Fetch Funding Rate History data from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (str): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
    startTime (Optional[int]): Start time in milliseconds since Unix epoch. If None, defaults to API behavior.
    endTime (Optional[int]): End time in milliseconds since Unix epoch. If None, defaults to API behavior.
    limit (Optional[int]): Number of funding rate records to return (1 to 1000). If None, defaults to 100.

Returns:
    str: Markdown table containing symbol, fundingTime, and fundingRate.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol (required), startTime, endTime, limit.

get_index_price_klineA
Fetch Index Price Kline/Candlestick data from Aster Finance API and return as Markdown table text.

Parameters:
    pair (str): Index pair (e.g., 'BTCUSD', 'ETHUSD'). Case-insensitive.
    interval (str): Kline interval (e.g., '1m' for 1 minute, '1h' for 1 hour, '1d' for 1 day).
    startTime (Optional[int]): Start time in milliseconds since Unix epoch. If None, defaults to API behavior.
    endTime (Optional[int]): End time in milliseconds since Unix epoch. If None, defaults to API behavior.
    limit (Optional[int]): Number of Klines to return (1 to 1500). If None, defaults to 500.

Returns:
    str: Markdown table containing open_time, open, high, low, and close.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: pair (required), interval (required), startTime, endTime, +1 more.

get_klineA
Fetch Kline/Candlestick data from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (str): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
    interval (str): Kline interval (e.g., '1m' for 1 minute, '1h' for 1 hour, '1d' for 1 day).
    startTime (Optional[int]): Start time in milliseconds since Unix epoch. If None, defaults to API behavior.
    endTime (Optional[int]): End time in milliseconds since Unix epoch. If None, defaults to API behavior.
    limit (Optional[int]): Number of Klines to return (1 to 1500). If None, defaults to 500.

Returns:
    str: Markdown table containing open_time, open, high, low, and close.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol (required), interval (required), startTime, endTime, +1 more.

get_latest_priceA
Fetch latest price data from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (Optional[str]): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
                           If None, returns data for all symbols.

Returns:
    str: Markdown table containing symbol and price.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol.

get_mark_price_klineA
Fetch Mark Price Kline/Candlestick data from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (str): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
    interval (str): Kline interval (e.g., '1m' for 1 minute, '1h' for 1 hour, '1d' for 1 day).
    startTime (Optional[int]): Start time in milliseconds since Unix epoch. If None, defaults to API behavior.
    endTime (Optional[int]): End time in milliseconds since Unix epoch. If None, defaults to API behavior.
    limit (Optional[int]): Number of Klines to return (1 to 1500). If None, defaults to 500.

Returns:
    str: Markdown table containing open_time, open, high, low, and close.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol (required), interval (required), startTime, endTime, +1 more.

get_order_bookA
Fetch order book data from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (str): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
    limit (Optional[int]): Number of order book entries to return (5, 10, 20, 50, 100, 500, 1000, 5000).
                          If None, defaults to 100.

Returns:
    str: Markdown table containing side (bid or ask), price, and quantity.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol (required), limit.

get_order_book_tickerA
Fetch order book ticker data from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (Optional[str]): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
                           If None, returns data for all symbols.

Returns:
    str: Markdown table containing symbol, bidPrice, bidQty, askPrice, and askQty.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol.

get_premium_indexA
Fetch Premium Index data from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (Optional[str]): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
                           If None, returns data for all symbols.

Returns:
    str: Markdown table containing symbol, markPrice, indexPrice, lastFundingRate, and nextFundingTime.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol.

get_price_change_statistics_24hA
Fetch 24-hour ticker price change statistics from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (Optional[str]): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
                           If None, returns data for all symbols.

Returns:
    str: Markdown table containing symbol, priceChange, priceChangePercent, lastPrice, and volume.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol.

get_recent_tradesA
Fetch recent trades data from Aster Finance API and return as Markdown table text.

Parameters:
    symbol (str): Trading pair symbol (e.g., 'BTCUSDT', 'ETHUSDT'). Case-insensitive.
    limit (Optional[int]): Number of trades to return (1 to 1000). If None, defaults to 500.

Returns:
    str: Markdown table containing tradeId, price, qty, quoteQty, time, and isBuyerMaker.

Raises:
    Exception: If the API request fails or data processing encounters an error.

Inputs: symbol (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.2/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes focused on different market data types (trades, order book, klines, funding rates, etc.), but there is some potential confusion between get_kline and get_mark_price_kline/get_index_price_kline which all return candlestick data with similar parameters. The descriptions help differentiate them by specifying price types (spot vs. mark vs. index).

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with 'get_' prefix followed by descriptive snake_case identifiers (e.g., get_aggregated_trades, get_funding_rate_history). The naming is highly predictable and follows the same convention throughout the entire set.

    Tool Count5/5

    With 11 tools, this is well-scoped for a financial market data API server. Each tool serves a distinct data endpoint (trades, order book, prices, klines, funding info), and the count aligns perfectly with typical market data coverage without being overwhelming or insufficient.

    Completeness4/5

    The tool set provides comprehensive read-only coverage of market data endpoints including trades, order books, prices, klines/candlesticks, and funding information. The only minor gap is the absence of tools for account-related data or trading operations, but for a pure market data server, the coverage is quite complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • AsterDex MCP Server

      solenyaresearch0000
      F
      license
      Not graded
      quality
      D
      maintenance
      Provides access to AsterDex perpetual futures market data including real-time order books, candlestick charts, funding rates, and price statistics for cryptocurrency trading pairs.
      -

    • 0xarchive-mcp

      0xArchiveIO
      A
      license
      B
      quality
      B
      maintenance
      MCP server for querying historical and real-time crypto market data across Hyperliquid, Hyperliquid HIP-3, and Lighter.xyz - orderbooks, trades, candles, funding, open interest, liquidations, and data quality metrics.
      100
      64 npm
      13
      MIT
    • Dataline MCP Server

      Dataline MCP Serverofficial

      dataline-xyz
      A
      license
      A
      quality
      D
      maintenance
      MCP server exposing read-only market data tools for crypto prices, funding rates, and prediction markets via Dataline API.
      8
      14 npm
      MIT