Referencia de la API (Clave API)

Especificaciones técnicas para los endpoints de la API del Agente Minara.

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

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

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

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

Endpoint

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

Cuerpo de la petición

Parámetro	Tipo	Requerido	Descripción
modo	cadena	Sí	Modo del modelo: 'fast' para respuestas rápidas, 'expert' para análisis en profundidad.
stream	booleano	Sí	Establecer en true para streaming (SSE), false para respuesta JSON estándar.
mensaje	objeto	Sí	Objeto mensaje con rol y contenido
mensaje.rol	cadena	Sí	Rol del remitente del mensaje, debe ser 'user'.
mensaje.contenido	cadena	Sí	El contenido de la consulta del usuario.

Ejemplo de petición

curl -X POST https://api-developer.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 acción de precio reciente 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": "SOL se está negociando actualmente a $187.50, con un aumento del 4.2% en las últimas 24 horas. Basado en el gráfico de 4H, ha roto por encima de la resistencia clave en $185 con volumen fuerte. El RSI está en 62, lo que indica impulso alcista sin estar sobrecomprado. \n\nSugerencia: Considera una posición larga con entrada alrededor de $186-188, toma de ganancias en $195 y stop loss en $180...",
  "usage": {}
}

Respuesta en streaming (stream: true)

Devuelve Content-Type: text/event-stream usando 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, con un aumento del 4.2% 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":"Basado en el gráfico de 4H, ha roto por encima de la resistencia clave en $185 con volumen fuerte.\n"},"finish_reason":null}]}

data: [DONE]

---

Intento de transacción de swap

Endpoint

POST https://api-developer.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 petición

Parámetro	Tipo	Requerido	Descripción
intención	cadena	Sí	Intención de swap en lenguaje natural (p. ej., "swap 0.1 ETH to USDC")
walletAddress	cadena	Sí	Dirección de la wallet del usuario (0x...)
chain	cadena	No	Nombre de la cadena (p. ej., "base", "ethereum", "bsc", "arbitrum", "optimism")

Ejemplo de petición

curl -X POST https://api-developer.minara.ai/v1/developer/intent-to-swap-tx \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "swap 0.1 ETH to 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 asignación es suficiente para el spender 0x57df6092665eb6058DE53939612413ff4B09114E"
  }
}

---

Sugerencia de trading perpetuo

Endpoint

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

Obtén sugerencias de trading perpetuo impulsadas por IA con recomendaciones long/short, precio de entrada, stop loss, niveles de toma de ganancias y puntaje de confianza basado en un análisis de mercado integral.

Cuerpo de la petición

Parámetro	Tipo	Requerido	Descripción
símbolo	cadena	Sí	Símbolo de trading (p. ej., "BTC", "ETH", "SOL")
estilo	cadena	No	Estilo de trading: "scalping", "day-trading" o "swing-trading"
marginUSD	número	No	Margen en USD
apalancamiento	número	No	Multiplicador de apalancamiento (máx.: 40)
estrategia	cadena	No	Tipo de estrategia (más estrategias próximamente)

Ejemplo de petición

curl -X POST https://api-developer.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 rompió por encima de la resistencia clave en $97,500 con volumen fuerte",
    "RSI en 62 indica impulso alcista sin estar sobrecomprado",
    "MACD muestra cruce alcista en el marco temporal de 4H",
    "El perfil de volumen muestra acumulación en los niveles actuales"
  ],
  "riesgos": [
    "Posible retroceso en la resistencia psicológica de $100,000",
    "Alta volatilidad esperada alrededor de la próxima reunión de la Fed",
    "Las tasas de financiación en los principales exchanges tienden al alza"
  ]
}

---

Análisis de mercados de predicción

Endpoint

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

Análisis de mercados de predicción impulsado por IA. Analiza eventos de mercados de predicción y obtiene estimaciones de probabilidad para cada resultado con razonamiento detallado.

Cuerpo de la petición

Parámetro	Tipo	Requerido	Descripción
enlace	cadena	Sí	Enlace a la página del mercado de predicción (p. ej., URL de evento de Polymarket)
modo	cadena	Sí	Modo de chat: "fast" o "expert"
solo_resultado	booleano	No	Devolver solo probabilidades de predicción sin razonamiento
promptPersonalizado	cadena	No	Instrucciones personalizadas para guiar el análisis

Ejemplo de petición

curl -X POST https://api-developer.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": "Enfócate en noticias recientes y 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 datos recientes de encuestas y tendencias históricas, Trump mantiene una ligera ventaja en estados clave. Sin embargo, la carrera sigue siendo altamente competitiva con incertidumbre significativa..."
}