Referencia de la API (clave API)

Especificaciones técnicas de los endpoints de la API de Minara Agent.

API para desarrolladores

El endpoint principal para interactuar con la IA conversacional de Minara.

Developer Chat

post

Developer chat endpoint supporting both streaming and non-streaming response modes.

Autorizaciones

BearerAuth

AuthorizationstringRequerido

Format: Authorization: Bearer <YOUR_API_KEY>

Cuerpo

application/json

modestring · enumRequerido

Required. Model mode: 'fast' for quick responses, 'expert' for in-depth analysis.

Valores posibles:

streambooleanRequerido

Required. Set to true for streaming (SSE), false for standard JSON response.

Respuestas

200

Successful response

application/jsontext/event-stream

chatIdstringOpcional

Unique conversation ID.

messageIdstringOpcional

Unique message ID for this response.

contentstringOpcional

The AI-generated response content.

usageobjectOpcional

Usage statistics for the request.

401

Unauthorized - Invalid or missing API key

post

/v1/developer/chat

HTTPcURLJavaScriptPython

POST /v1/developer/chat HTTP/1.1
Host: api-developer.minara.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "mode": "fast",
  "stream": false,
  "message": {
    "role": "user",
    "content": "Analyze the recent price action of SOL and give me a trading suggestion."
  }
}

{
  "chatId": "chat_abc123",
  "messageId": "msg_def456",
  "content": "SOL is currently trading at $187.50, up 4.2% in the last 24 hours...",
  "usage": {}
}

Intent to Swap Transaction

post

Convert natural language trading intent into an executable swap transaction payload. Compatible with OKX DEX by default.

Autorizaciones

BearerAuth

AuthorizationstringRequerido

Format: Authorization: Bearer <YOUR_API_KEY>

Cuerpo

application/json

intentstringRequerido

Required. Natural language swap intent (e.g., 'swap 0.1 ETH to USDC').

walletAddressstringRequerido

Required. User wallet address (0x...).

chainstringOpcional

Optional. Chain name (e.g., 'base', 'ethereum', 'bsc', 'arbitrum', 'optimism').

Respuestas

200

Swap transaction generated

application/json

401

Unauthorized - Invalid or missing API key

post

/v1/developer/intent-to-swap-tx

HTTPcURLJavaScriptPython

POST /v1/developer/intent-to-swap-tx HTTP/1.1
Host: api-developer.minara.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 109

{
  "intent": "swap 0.1 ETH to USDC",
  "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
  "chain": "base"
}

{
  "intent": {
    "chain": "base",
    "inputTokenAddress": null,
    "inputTokenSymbol": "ETH",
    "outputTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "outputTokenSymbol": "USDC",
    "amount": "100000000000000000",
    "userWalletAddress": "0x42a345F3d379B5060f0C36580bAF22C395B1D462"
  },
  "quote": {
    "fromTokenAmount": "100000000000000000",
    "toTokenAmount": "194058559",
    "estimatedGas": "1338000",
    "priceImpact": "-0.03",
    "tradeFee": "0.0174870969512694"
  },
  "inputToken": {
    "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "symbol": "ETH",
    "decimals": "18",
    "unitPrice": "1960.63"
  },
  "outputToken": {
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "symbol": "USDC",
    "decimals": "6",
    "unitPrice": "0.99989"
  },
  "unsignedTx": {
    "chainType": "evm",
    "from": "0x42a345F3d379B5060f0C36580bAF22C395B1D462",
    "to": "0x4409921ae43a39a11d90f7b96cfd0b8093d9fc",
    "data": "0xf2c42696...",
    "value": "100000000000000000",
    "gas": "1338000",
    "gasPrice": "10943011",
    "maxPriorityFeePerGas": "7301883"
  },
  "approval": {
    "isRequired": false,
    "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "spenderAddress": "0x57df6092665eb6058DE53939612413ff4B09114E",
    "requiredAmount": "10000000",
    "approveAmount": "10000000",
    "currentAllowance": "115792089237316195423570985008687907853269984665640564039457584007913129316681",
    "message": "Allowance is sufficient for spender 0x57df6092665eb6058DE53939612413ff4B09114E"
  }
}

Perpetual Trading Suggestion

post

Get AI-powered perpetual trading suggestions with long/short recommendations, entry price, stop loss, take profit levels, and confidence score based on comprehensive market analysis.

Autorizaciones

BearerAuth

AuthorizationstringRequerido

Format: Authorization: Bearer <YOUR_API_KEY>

Cuerpo

application/json

symbolstringRequerido

Required. Trading symbol (e.g., 'BTC', 'ETH', 'SOL').

stylestring · enumOpcional

Optional. Trading style: 'scalping', 'day-trading', or 'swing-trading'. Default: 'scalping'.

Default: scalpingValores posibles:

marginUSDnumberOpcional

Optional. Margin in USD. Default: 1000.

Default: 1000

leveragenumber · mín: 1 · máx: 40Opcional

Optional. Leverage multiplier (max: 40). Default: 10.

Default: 10

strategystringOpcional

Optional. Strategy type. Default: 'max-profit'. More strategies coming soon.

Default: max-profit

Respuestas

200

Perpetual trading suggestion

application/json

entryPricenumberOpcional

Recommended entry price.

sidestring · enumOpcional

Trading side recommendation.

Valores posibles:

stopLossPricenumberOpcional

Recommended stop loss price.

takeProfitPricenumberOpcional

Recommended take profit price.

confidencenumber · máx: 100Opcional

Confidence score (0-100).

reasonsstring[]Opcional

Analysis reasons based on technical indicators.

risksstring[]Opcional

Risk factors to consider.

401

Unauthorized - Invalid or missing API key

post

/v1/developer/perp-trading-suggestion

HTTPcURLJavaScriptPython

POST /v1/developer/perp-trading-suggestion HTTP/1.1
Host: api-developer.minara.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "symbol": "BTC",
  "style": "day-trading",
  "marginUSD": 1000,
  "leverage": 10,
  "strategy": "max-profit"
}

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC broke above key resistance at $97,500 with strong volume",
    "RSI at 62 indicates bullish momentum without being overbought",
    "MACD showing bullish crossover on 4H timeframe",
    "Volume profile shows accumulation at current levels"
  ],
  "risks": [
    "Potential pullback at $100,000 psychological resistance",
    "High volatility expected around upcoming Fed meeting",
    "Funding rates on major exchanges trending higher"
  ]
}

Prediction Market Analysis

post

AI-powered prediction market analysis. Analyze prediction market events and get probability estimates for each outcome with detailed reasoning.

Autorizaciones

BearerAuth

AuthorizationstringRequerido

Format: Authorization: Bearer <YOUR_API_KEY>

Cuerpo

application/json

linkstringRequerido

Required. Prediction market page link (e.g., Polymarket event URL).

modestring · enumRequerido

Required. Chat mode: 'fast' or 'expert'.

Valores posibles:

only_resultbooleanOpcional

Optional. Only return prediction probabilities without reasoning. Default: false.

Default: false

customPromptstringOpcional

Optional. Custom instructions to guide the analysis. Use this to specify focus areas, risk preferences, or analysis style.

Respuestas

200

Prediction market analysis

application/json

reasoningstringOpcional

AI reasoning and analysis (empty if only_result=true).

401

Unauthorized - Invalid or missing API key

post

/v1/developer/prediction-market-ask

HTTPcURLJavaScriptPython

POST /v1/developer/prediction-market-ask HTTP/1.1
Host: api-developer.minara.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 241

{
  "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31",
  "mode": "fast",
  "only_result": false,
  "customPrompt": "Focus on recent news and sentiment analysis. Be more conservative in probability estimates."
}

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "Based on recent polling data and historical trends, Trump maintains a slight lead in key swing states. However, the race remains highly competitive with significant uncertainty..."
}

API para desarrolladores

Chat

Punto final

POST https://api.minara.ai/v1/developer/chat

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
mode	string	Sí	Modo del modelo: 'fast' para respuestas rápidas, 'expert' para análisis en profundidad.
stream	boolean	Sí	Establécelo en true para streaming (SSE), false para una respuesta JSON estándar.
mensaje	objeto	Sí	Objeto de mensaje con rol y contenido
message.role	string	Sí	Rol del remitente del mensaje, debe ser 'user'.
message.content	string	Sí	El contenido de la consulta del usuario.

Ejemplo de solicitud

curl -X POST https://api.minara.ai/v1/developer/chat \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "fast",
    "stream": false,
    "message": {
      "role": "user",
      "content": "Analiza la reciente acción del precio de SOL y dame una sugerencia de trading."
    }
  }'

Respuestas

Respuesta estándar (stream: false)

Devuelve un objeto JSON con la respuesta completa.

{
  "chatId": "chat_abc123",
  "messageId": "msg_def456",
  "content": "Actualmente SOL cotiza a $187.50, un 4.2% al alza en las últimas 24 horas. Basándose en el gráfico de 4H, ha superado la resistencia clave en $185 con un fuerte volumen. RSI está en 62, lo que indica un impulso alcista sin estar sobrecomprado. \n\nSugerencia: Considera una posición larga con entrada alrededor de $186-188, toma ganancias en $195 y stop loss en $180...",
  "usage": {}
}

Respuesta en streaming (stream: true)

Devuelve Content-Type: text/event-stream utilizando Server-Sent Events (SSE).

data: {"chatId":"chat_abc123","messageId":"msg_def456","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"chatId":"chat_abc123","messageId":"msg_def456","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"SOL se está negociando actualmente a $187.50, un 4.2% más en las últimas 24 horas.\n"},"finish_reason":null}]}

data: {"chatId":"chat_abc123","messageId":"msg_def456","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Según el gráfico de 4H, ha superado la resistencia clave en $185 con un fuerte volumen.\n"},"finish_reason":null}]}

data: [DONE]

---

Transacción de intención de swap

Punto final

POST https://api.minara.ai/v1/developer/intent-to-swap-tx

Convierte la intención de trading en lenguaje natural en una carga útil de transacción de swap ejecutable. Compatible con OKX DEX por defecto.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
intent	string	Sí	Intención de intercambio en lenguaje natural (por ejemplo, "intercambia 0.1 ETH por USDC")
walletAddress	string	Sí	Dirección de la billetera del usuario (0x...)
chain	string	No	Nombre de la cadena (p. ej., "base", "ethereum", "bsc", "arbitrum", "optimism")

Ejemplo de solicitud

curl -X POST https://api.minara.ai/v1/developer/intent-to-swap-tx \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "intercambia 0.1 ETH por USDC",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
    "chain": "base"
  }'

Respuesta

{
  "intent": {
    "chain": "base",
    "inputTokenAddress": null,
    "inputTokenSymbol": "ETH",
    "outputTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "outputTokenSymbol": "USDC",
    "amount": "100000000000000000",
    "userWalletAddress": "0x42a345F3d379B5060f0C36580bAF22C395B1D462"
  },
  "quote": {
    "fromTokenAmount": "100000000000000000",
    "toTokenAmount": "194058559",
    "estimatedGas": "1338000",
    "priceImpact": "-0.03",
    "tradeFee": "0.0174870969512694"
  },
  "inputToken": {
    "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "symbol": "ETH",
    "decimals": "18",
    "unitPrice": "1960.63"
  },
  "outputToken": {
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "symbol": "USDC",
    "decimals": "6",
    "unitPrice": "0.99989"
  },
  "unsignedTx": {
    "chainType": "evm",
    "from": "0x42a345F3d379B5060f0C36580bAF22C395B1D462",
    "to": "0x4409921ae43a39a11d90f7b96cfd0b8093d9fc",
    "data": "0xf2c42696000000000000000000000000000000000000000000000000000000000003479e...",
    "value": "100000000000000000",
    "gas": "1338000",
    "gasPrice": "10943011",
    "maxPriorityFeePerGas": "7301883"
  },
  "approval": {
    "isRequired": false,
    "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "spenderAddress": "0x57df6092665eb6058DE53939612413ff4B09114E",
    "requiredAmount": "10000000",
    "approveAmount": "10000000",
    "currentAllowance": "115792089237316195423570985008687907853269984665640564039457584007913129316681",
    "message": "La autorización es suficiente para el spender 0x57df6092665eb6058DE53939612413ff4B09114E"
  }
}

---

Sugerencia de trading perpetuo

Punto final

POST https://api.minara.ai/v1/developer/perp-trading-suggestion

Obtén sugerencias de trading perpetuo potenciadas por IA con recomendaciones de largo/corto, precio de entrada, stop loss, niveles de take profit y puntuación de confianza basadas en un análisis exhaustivo del mercado.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
symbol	string	Sí	Símbolo de trading (por ejemplo, "BTC", "ETH", "SOL")
style	string	No	Estilo de trading: "scalping", "day-trading" o "swing-trading"
marginUSD	number	No	Margen en USD
leverage	number	No	Multiplicador de apalancamiento (máx.: 40)
strategy	string	No	Tipo de estrategia (más estrategias próximamente)

Ejemplo de solicitud

curl -X POST https://api.minara.ai/v1/developer/perp-trading-suggestion \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTC",
    "style": "day-trading",
    "marginUSD": 1000,
    "leverage": 10,
    "strategy": "max-profit"
  }'

Respuesta

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC superó la resistencia clave en $97,500 con fuerte volumen",
    "El RSI en 62 indica impulso alcista sin estar en sobrecompra",
    "El MACD muestra un cruce alcista en el marco temporal de 4H",
    "El perfil de volumen muestra acumulación en los niveles actuales"
  ],
  "risks": [
    "Posible retroceso en la resistencia psicológica de $100,000",
    "Se espera alta volatilidad en torno a la próxima reunión de la Fed",
    "Las tasas de financiación en los principales exchanges están tendiendo al alza"
  ]
}

---

Análisis del mercado de predicción

Punto final

POST https://api.minara.ai/v1/developer/prediction-market-ask

Análisis del mercado de predicción potenciado por IA. Analiza los eventos del mercado de predicción y obtén estimaciones de probabilidad para cada resultado con razonamiento detallado.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
link	string	Sí	Enlace de la página del mercado de predicción (p. ej., URL del evento de Polymarket)
mode	string	Sí	Modo de chat: "fast" o "expert"
only_result	boolean	No	Devuelve solo las probabilidades de predicción sin razonamiento
customPrompt	string	No	Instrucciones personalizadas para guiar el análisis

Ejemplo de solicitud

curl -X POST https://api.minara.ai/v1/developer/prediction-market-ask \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31",
    "mode": "fast",
    "only_result": false,
    "customPrompt": "Céntrate en las noticias recientes y el análisis de sentimiento. Sé más conservador en las estimaciones de probabilidad."
  }'

Respuesta

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "Basado en los datos de encuestas recientes y las tendencias históricas, Trump mantiene una ligera ventaja en los principales estados bisagra. Sin embargo, la contienda sigue siendo muy competitiva, con una incertidumbre significativa..."
}