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.
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)
- Dados de candles (
- 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
-
Clone o Repositório:
git clone https://github.com/kukapay/aster-info-mcp.git cd aster-info-mcp -
Instale as Dependências:
uv sync -
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-mcppelo seu caminho real de instalação.
Uso
Ferramentas Disponíveis
| Nome da Ferramenta | Descrição | Parâmetros |
|---|---|---|
get_kline | Busca dados de candles para um símbolo. | symbol, interval, startTime (opc), endTime (opc), limit (opc) |
get_index_price_kline | Busca dados de candles do preço de índice para um par. | pair, interval, startTime (opc), endTime (opc), limit (opc) |
get_mark_price_kline | Busca dados de candles do preço de marcação para um símbolo. | symbol, interval, startTime (opc), endTime (opc), limit (opc) |
get_premium_index | Busca dados do índice premium (preço de marcação, taxa de funding). | symbol (opc) |
get_funding_rate_history | Busca dados históricos de taxa de funding para um símbolo. | symbol, startTime (opc), endTime (opc), limit (opc) |
get_price_change_statistics_24h | Busca estatísticas de variação de preço em 24 horas. | symbol (opc) |
get_latest_price | Busca o preço mais recente para um símbolo ou todos os símbolos. | symbol (opc) |
get_order_book_ticker | Busca dados de ticker do livro de ofertas (melhores preços e quantidades de compra/venda). | symbol (opc) |
get_order_book | Busca dados do livro de ofertas (ofertas de compra e venda) para um símbolo. | symbol, limit (opc) |
get_recent_trades | Busca negociações recentes para um símbolo. | symbol, limit (opc) |
get_historical_trades | Busca negociações históricas para um símbolo. | symbol, limit (opc), fromId (opc) |
get_aggregated_trades | Busca 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.