API 参考（API 密钥）

Minara Agent API 端点的技术规格。

开发者 API

与 Minara 会话式 AI 交互的核心端点。

Developer Chat

post

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

授权

BearerAuth

Authorizationstring必填

Format: Authorization: Bearer <YOUR_API_KEY>

请求体

application/json

modestring · enum必填

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

可能的值:

streamboolean必填

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

响应

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.

授权

BearerAuth

Authorizationstring必填

Format: Authorization: Bearer <YOUR_API_KEY>

请求体

application/json

intentstring必填

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

walletAddressstring必填

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

chainstring可选

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

响应

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.

授权

BearerAuth

Authorizationstring必填

Format: Authorization: Bearer <YOUR_API_KEY>

请求体

application/json

symbolstring必填

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

stylestring · enum可选

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

Default: scalping可能的值:

marginUSDnumber可选

Optional. Margin in USD. Default: 1000.

Default: 1000

leveragenumber · 最小值: 1 · 最大值: 40可选

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

Default: 10

strategystring可选

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

Default: max-profit

响应

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.

授权

BearerAuth

Authorizationstring必填

Format: Authorization: Bearer <YOUR_API_KEY>

请求体

application/json

linkstring必填

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

modestring · enum必填

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

可能的值:

only_resultboolean可选

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

Default: false

customPromptstring可选

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

响应

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

聊天

端点

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

请求体

参数	类型	是否必需	说明
mode	字符串	是	模型模式：'fast' 用于快速响应，'expert' 用于深入分析。
stream	布尔值	是	设置为 true 使用流式（SSE），false 返回标准 JSON 响应。
message	对象	是	包含角色和内容的消息对象
message.role	字符串	是	消息发送者角色，必须为 'user'。
message.content	字符串	是	用户的查询内容。

示例请求

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": "分析 SOL 最近的价格走势并给出交易建议。"
    }
  }'

响应

标准响应（stream: false）

返回包含完整响应的 JSON 对象。

{
  "chatId": "chat_abc123",
  "messageId": "msg_def456",
  "content": "SOL 当前交易价格为 $187.50，过去 24 小时上涨 4.2%。基于 4 小时图表，它已以较大成交量突破 $185 的关键阻力位。RSI 为 62，表明有看涨动能且未超买。 \n\n建议：考虑在 $186-188 区间做多，止盈设在 $195，止损设在 $180...",
  "usage": {}
}

流式响应（stream: true）

返回 Content-Type: text/event-stream 使用服务器发送事件（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 当前交易价格为 $187.50，过去 24 小时上涨 4.2%。\n"},"finish_reason":null}]}

data: {"chatId":"chat_abc123","messageId":"msg_def456","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"基于 4 小时图表，它已以较大成交量突破 $185 的关键阻力位。\n"},"finish_reason":null}]}

data: [DONE]

---

意向换汇交易（Intent to Swap Transaction）

端点

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

将自然语言的交易意图转换为可执行的换汇交易负载。默认兼容 OKX DEX。

请求体

参数	类型	是否必需	说明
intent	字符串	是	自然语言的换汇意图（例如，"swap 0.1 ETH to USDC"）
walletAddress	字符串	是	用户钱包地址（0x...）
chain	字符串	否	链名称（例如，"base"、"ethereum"、"bsc"、"arbitrum"、"optimism"）

示例请求

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

响应

{
  "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": "Allowance is sufficient for spender 0x57df6092665eb6058DE53939612413ff4B09114E"
  }
}

---

永续合约交易建议

端点

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

获取由 AI 提供的永续合约交易建议，包括多/空建议、入场价、止损、止盈水平以及基于全面市场分析的置信度评分。

请求体

参数	类型	是否必需	说明
symbol	字符串	是	交易标的（例如，"BTC"、"ETH"、"SOL"）
style	字符串	否	交易风格："scalping"、"day-trading" 或 "swing-trading"
marginUSD	数字	否	以美元计的保证金
leverage	数字	否	杠杆倍数（最大：40）
strategy	字符串	否	策略类型（更多策略即将推出）

示例请求

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

响应

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC 在 $97,500 的关键阻力位上方突破，伴随强劲成交量",
    "RSI 为 62，表明有看涨动能且未超买",
    "MACD 在 4 小时周期显示看涨交叉",
    "成交量分布显示当前价位有吸筹迹象"
  ],
  "risks": [
    "在 $100,000 的心理阻力位可能出现回撤",
    "美联储即将召开会议期间预计波动性较高",
    "主要交易所的资金费率呈上升趋势"
  ]
}

---

预测市场分析

端点

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

由 AI 提供的预测市场分析。分析预测市场事件并为每个结果给出概率估计及详细推理。

请求体

参数	类型	是否必需	说明
link	字符串	是	预测市场页面链接（例如 Polymarket 事件 URL）
mode	字符串	是	聊天模式："fast" 或 "expert"
only_result	布尔值	否	仅返回预测概率，不包含推理
customPrompt	字符串	否	用于指导分析的自定义指令

示例请求

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": "关注近期新闻和情绪分析。在概率估计上更为保守。"
  }'

响应

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "基于最近的民调数据和历史趋势，特朗普在关键摇摆州保持微弱领先。但竞赛仍高度竞争且存在显著不确定性..."
}