API-ключ

Метод API Key доступен для Про и Partner пользователям тарифных планов. Создавайте ключи из своего профиля Minara и добавляйте их в Authorization заголовок каждого запроса.

---

Требования

API Minara Agent доступен исключительно подписчикам тарифов Pro и Partner. Если у вас бесплатный тариф, перейдите на API вкладку в своем профиле, чтобы увидеть предложение об обновлении.

Если вы понизите тариф, все активные API-ключи автоматически приостанавливаются и возобновятся после продления.

---

Создание API-ключа

1. Перейдите в свой Профиль аккаунта в minara.ai.
2. Выберите API Key вкладку в левом меню и нажмите Создать.

1. Введите имя и описание, чтобы обозначить назначение ключа.

1. После создания ваш API-ключ отображается. Скопируйте и надежно сохраните его — он больше не будет показан.

---

Управление API-ключами

Действие	Подробности
Просмотр ключей	Ключи отображаются в списке только с видимыми последними 4 символами. Нажмите, чтобы раскрыть полный ключ.
Лимит ключей	До 5 API-ключей на аккаунт Pro/Partner.
Удалить ключ	Требуется подтверждение 2FA. Удаление необратимо.

---

Аутентификация

Добавьте свой API-ключ в Authorization заголовок каждого запроса:

Authorization: Bearer <YOUR_API_KEY>

Пример:

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

Относитесь к своим API-ключам как к паролям. Никогда не публикуйте их в клиентском коде или общедоступных репозиториях.

---

Оплата

Все API-вызовы расходуют кредиты из вашего аккаунта Minara. Если кредиты закончатся, API-запросы приостанавливаются до пополнения.

---

Справка по API

Базовый URL: https://api.minara.ai

Чат

POST /v1/developer/chat

Developer Chat

post

Developer chat endpoint supporting streaming, non-streaming, and asynchronous (background) response modes, with optional requestId-based idempotency.

Authorizations

BearerAuth

AuthorizationstringRequired

Format: Authorization: Bearer <YOUR_API_KEY>

Body

application/json

modestring · enumRequired

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

Possible values:

streambooleanOptional

Optional. Set to true for streaming (SSE), false (default) for standard JSON response. Cannot be combined with background.

Default: false

backgroundbooleanOptional

Optional. Set to true to run a non-streaming request asynchronously and poll the result later. Requires stream: false.

Default: false

requestIdstring · min: 1 · max: 128Optional

Optional. Client-generated idempotency key, unique within the API key. 1-128 chars matching ^[A-Za-z0-9._:-]+$.

Pattern: ^[A-Za-z0-9._:-]+$

chatIdstringOptional

Optional. Existing chat to continue. A new chat is created if omitted.

Responses

200

Successful response (stream/background not set, or a completed idempotent replay).

application/jsontext/event-stream

idstringOptional

Server-assigned request id. Present when a requestId was supplied.

requestIdstringOptional

Your idempotency key, echoed when one was provided.

chatIdstringOptional

Unique conversation ID.

messageIdstringOptional

Unique message ID for this response.

contentstringOptional

The AI-generated response content.

usageobjectOptional

Usage statistics for the request.

202

Accepted. Returned for background requests, or when an idempotent request is still running.

application/json

400

Bad Request. E.g. combining background=true with stream=true.

401

Unauthorized - Invalid or missing API key

409

Conflict. The requestId was already used with a different request, or has expired and cannot be reused.

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

{
  "mode": "fast",
  "stream": false,
  "background": false,
  "requestId": "text",
  "chatId": "text",
  "message": {
    "role": "user",
    "content": "text"
  }
}

{
  "id": "text",
  "requestId": "text",
  "chatId": "text",
  "messageId": "text",
  "content": "text",
  "usage": {}
}

Параметр	Тип	Требуется	Описание
mode	string	Да	fast для быстрых ответов, expert для глубокого анализа
stream	boolean	Да	true для потоковой передачи SSE, false для стандартного JSON
message.role	string	Да	Должно быть user
message.content	string	Да	Содержимое запроса

Пример:

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": "Проанализируй недавнее движение цены SOL." }
  }'

---

Предположение о транзакции свопа

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.

Authorizations

BearerAuth

AuthorizationstringRequired

Format: Authorization: Bearer <YOUR_API_KEY>

Body

application/json

intentstringRequired

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

walletAddressstringRequired

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

chainstringOptional

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

Responses

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

Преобразуйте торговое намерение на естественном языке в исполняемый payload транзакции свопа, по умолчанию совместимый с OKX DEX.

Параметр	Тип	Требуется	Описание
intent	string	Да	Намерение свопа на естественном языке (например, "обменяй 0.1 ETH на USDC")
walletAddress	string	Да	Адрес кошелька пользователя (0x...)
chain	string	Нет	Название сети (например, "base", "ethereum", "arbitrum")

Пример:

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": "обменять 0.1 ETH на USDC",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
    "chain": "base"
  }'

---

Рекомендация по бессрочной торговле

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.

Authorizations

BearerAuth

AuthorizationstringRequired

Format: Authorization: Bearer <YOUR_API_KEY>

Body

application/json

symbolstringRequired

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

stylestring · enumOptional

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

Default: scalpingPossible values:

marginUSDnumberOptional

Optional. Margin in USD. Default: 1000.

Default: 1000

leveragenumber · min: 1 · max: 40Optional

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

Default: 10

strategystringOptional

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

Default: max-profit

Responses

200

Perpetual trading suggestion

application/json

entryPricenumberOptional

Recommended entry price.

sidestring · enumOptional

Trading side recommendation.

Possible values:

stopLossPricenumberOptional

Recommended stop loss price.

takeProfitPricenumberOptional

Recommended take profit price.

confidencenumber · max: 100Optional

Confidence score (0-100).

reasonsstring[]Optional

Analysis reasons based on technical indicators.

risksstring[]Optional

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

{
  "symbol": "text",
  "style": "scalping",
  "marginUSD": 1000,
  "leverage": 10,
  "strategy": "max-profit"
}

{
  "entryPrice": 1,
  "side": "long",
  "stopLossPrice": 1,
  "takeProfitPrice": 1,
  "confidence": 1,
  "reasons": [
    "text"
  ],
  "risks": [
    "text"
  ]
}

Получайте рекомендации по бессрочной торговле на основе ИИ с рекомендациями long/short, точкой входа, стоп-лоссом, тейк-профитом и оценкой уверенности.

Параметр	Тип	Требуется	Описание
symbol	string	Да	Торговый символ (например, "BTC", "ETH", "SOL")
style	string	Нет	scalping, day-trading или swing-trading
marginUSD	number	Нет	Маржа в USD
leverage	number	Нет	Множитель кредитного плеча (макс.: 40)
strategy	string	Нет	Тип стратегии

Пример:

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

---

Анализ рынка прогнозов

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.

Authorizations

BearerAuth

AuthorizationstringRequired

Format: Authorization: Bearer <YOUR_API_KEY>

Body

application/json

linkstringRequired

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

modestring · enumRequired

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

Possible values:

only_resultbooleanOptional

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

Default: false

customPromptstringOptional

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

Responses

200

Prediction market analysis

application/json

reasoningstringOptional

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

{
  "link": "text",
  "mode": "fast",
  "only_result": false,
  "customPrompt": "text"
}

{
  "predictions": [
    {
      "outcome": "text",
      "yesProb": 1,
      "noProb": 1
    }
  ],
  "reasoning": "text"
}

Оценки вероятностей исходов на рынках прогнозов на основе ИИ.

Параметр	Тип	Требуется	Описание
link	string	Да	URL события на рынке прогнозов (например, Polymarket)
mode	string	Да	fast или expert
only_result	boolean	Нет	Возвращать только вероятности, без объяснения
customPrompt	string	Нет	Пользовательские инструкции для направления анализа

Пример:

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