Clave API

El método de clave API está disponible para Pro y Socio usuarios del plan. Genera claves desde tu perfil de Minara e inclúyelas en el Autorización encabezado de cada solicitud.

---

Requisitos

La API de Minara Agent está disponible exclusivamente para suscriptores de los planes Pro y Partner. Si estás en un plan gratuito, ve a la API pestaña de tu perfil para ver el aviso de actualización.

Si rebajas tu suscripción, todas las claves API activas se pausan automáticamente y se reanudan cuando renuevas.

---

Creación de una clave API

1. Ve a tu Perfil de la cuenta en minara.ai.
2. Selecciona la Clave API pestaña del menú izquierdo y haz clic en Crear.

1. Introduce un nombre y una descripción para identificar el uso de la clave.

1. Una vez creada, se mostrará tu clave API. Cópiala y guárdala de forma segura — no se volverá a mostrar.

---

Gestión de claves API

Acción	Detalles
Ver claves	Las claves se muestran con solo los últimos 4 caracteres visibles. Haz clic para revelar la clave completa.
Límite de claves	Hasta 5 claves API por cuenta Pro/Partner.
Eliminar clave	Requiere confirmación de 2FA. La eliminación es permanente.

---

Autenticación

Incluye tu clave API en el Autorización encabezado de cada solicitud:

Authorization: Bearer <YOUR_API_KEY>

Ejemplo:

curl -H "Authorization: Bearer sk-minara-xxxxxxxx" \\
  https://api.minara.ai/v1/developer/chat

Trata tus claves API como contraseñas. Nunca las expongas en código del lado del cliente ni en repositorios públicos.

---

Facturación

Todas las llamadas a la API consumen créditos de tu cuenta de Minara. Si se agotan los créditos, las solicitudes a la API se pausan hasta que se repongan.

---

Referencia de la API

URL base: https://api.minara.ai

Chat

POST /v1/developer/chat

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": {}
}

Parámetro	Tipo	Requerido	Descripción
mode	cadena	Sí	fast para respuestas rápidas, expert para análisis en profundidad
stream	booleano	Sí	verdadero para transmisión SSE, falso para JSON estándar
message.role	cadena	Sí	Debe ser user
message.content	cadena	Sí	El contenido de la consulta

Ejemplo:

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." }
  }'

---

Intención de transacción de intercambio

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

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

Convierte una intención de trading en lenguaje natural en un payload ejecutable de transacción de intercambio, compatible de forma predeterminada con OKX DEX.

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

Ejemplo:

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"
  }'

---

Sugerencia de trading perpetuo

POST /v1/developer/perp-trading-suggestion

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"
  ]
}

Obtén sugerencias de trading perpetuo impulsadas por IA con recomendaciones long/short, entrada, stop loss, take profit y puntuación de confianza.

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

Ejemplo:

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

---

Análisis del mercado de predicción

POST /v1/developer/prediction-market-ask

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..."
}

Estimaciones de probabilidad impulsadas por IA para los resultados del mercado de predicción.

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

Ejemplo:

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/example",
    "mode": "fast"
  }'