Aster Info MCP

Fornece acesso estruturado aos dados de mercado da Aster DEX, incluindo candlesticks, livros de ordens, negociações e taxas de funding.

Documentação

Aster Info MCP

Um servidor MCP que fornece acesso estruturado aos dados de mercado do Aster DEX, abrangendo candles, livros de ofertas, negociações e taxas de funding.

GitHub License Python Version Status

Recursos

  • 13 Ferramentas: Acesse uma variedade de endpoints da API de Futuros da Aster Finance, incluindo:
    • Dados de candles (get_kline, get_index_price_kline, get_mark_price_kline)
    • Dados de preço e ticker (get_latest_price, get_price_change_statistics_24h, get_order_book_ticker)
    • Dados de livro de ofertas e negociações (get_order_book, get_recent_trades, get_historical_trades, get_aggregated_trades)
    • Dados de funding e índice (get_premium_index, get_funding_rate_history)
  • Saída em Markdown: Todas as ferramentas retornam dados como tabelas Markdown formatadas para fácil leitura e integração.
  • Tratamento Robusto de Erros: Lida com erros HTTP (ex.: 400, 429) e problemas de processamento de dados com exceções claras.

Instalação

Pré-requisitos

  • Python 3.10 ou superior
  • uv (gerenciador de pacotes recomendado)

Passos

  1. Clone o Repositório:

    git clone https://github.com/kukapay/aster-info-mcp.git
    cd aster-info-mcp
    
  2. Instale as Dependências:

    uv sync
    
  3. Instalando no Claude Desktop:

    Instale o servidor como um aplicativo do Claude Desktop:

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

    Arquivo de configuração como referência:

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

    Substitua /path/to/aster-info-mcp pelo seu caminho real de instalação.

Uso

Ferramentas Disponíveis

Nome da FerramentaDescriçãoParâmetros
get_klineBusca dados de candles para um símbolo.symbol, interval, startTime (opc), endTime (opc), limit (opc)
get_index_price_klineBusca dados de candles do preço de índice para um par.pair, interval, startTime (opc), endTime (opc), limit (opc)
get_mark_price_klineBusca dados de candles do preço de marcação para um símbolo.symbol, interval, startTime (opc), endTime (opc), limit (opc)
get_premium_indexBusca dados do índice premium (preço de marcação, taxa de funding).symbol (opc)
get_funding_rate_historyBusca dados históricos de taxa de funding para um símbolo.symbol, startTime (opc), endTime (opc), limit (opc)
get_price_change_statistics_24hBusca estatísticas de variação de preço em 24 horas.symbol (opc)
get_latest_priceBusca o preço mais recente para um símbolo ou todos os símbolos.symbol (opc)
get_order_book_tickerBusca dados de ticker do livro de ofertas (melhores preços e quantidades de compra/venda).symbol (opc)
get_order_bookBusca dados do livro de ofertas (ofertas de compra e venda) para um símbolo.symbol, limit (opc)
get_recent_tradesBusca negociações recentes para um símbolo.symbol, limit (opc)
get_historical_tradesBusca negociações históricas para um símbolo.symbol, limit (opc), fromId (opc)
get_aggregated_tradesBusca negociações agregadas para um símbolo.symbol, fromId (opc), startTime (opc), endTime (opc), limit (opc)

Observações:

  • Todas as ferramentas retornam dados como tabelas Markdown.
  • Parâmetros marcados com (opt) são opcionais.
  • Os timestamps estão em milissegundos (época Unix); as saídas são convertidas para formato de data/hora legível.
  • Os campos numéricos são arredondados para 8 casas decimais (exceto priceChangePercent, arredondado para 2).

Exemplos

Abaixo estão exemplos para cada uma das 13 ferramentas.

Exemplo: Buscando Dados de Candles (get_kline)

Prompt:

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

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Dados de Candles do Preço de Índice (get_index_price_kline)

Prompt:

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

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Dados de Candles do Preço de Marcação (get_mark_price_kline)

Prompt:

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

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Dados do Índice Premium (get_premium_index)

Prompt:

Show me the premium index data for ETHUSDT.

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Histórico de Taxa de Funding (get_funding_rate_history)

Prompt:

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

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Estatísticas de Variação de Preço em 24 Horas (get_price_change_statistics_24h)

Prompt:

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

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Preço Mais Recente (get_latest_price)

Prompt:

Show me the current price of BTCUSDT.

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Dados de Ticker do Livro de Ofertas (get_order_book_ticker)

Prompt:

Get the best bid and ask prices for ETHUSDT.

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Dados do Livro de Ofertas (get_order_book)

Prompt:

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

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Negociações Recentes (get_recent_trades)

Prompt:

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

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Negociações Históricas (get_historical_trades)

Prompt:

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

Resposta esperada (tabela Markdown):

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

Exemplo: Buscando Negociações Agregadas (get_aggregated_trades)

Prompt:

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

Resposta esperada (tabela Markdown):

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

Licença

Este projeto está licenciado sob a Licença MIT.