APIリファレンス（APIキー）

Minara Agent API エンドポイントの技術仕様。

開発者向けAPI

Minaraの会話型AIとやり取りするための主要なエンドポイント。

Developer Chat

post

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

認可

Authorizationstring必須

Format: Authorization: Bearer <YOUR_API_KEY>

本文

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

401

Unauthorized - Invalid or missing API key

post

/v1/developer/chat

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.

認可

Authorizationstring必須

Format: Authorization: Bearer <YOUR_API_KEY>

本文

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

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.

認可

Authorizationstring必須

Format: Authorization: Bearer <YOUR_API_KEY>

本文

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

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.

認可

Authorizationstring必須

Format: Authorization: Bearer <YOUR_API_KEY>

本文

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

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

string

はい

モデルモード：迅速な応答のための 'fast'、詳細な分析のための 'expert'。

stream

boolean

はい

ストリーミング（SSE）にする場合は true、標準のJSONレスポンスにする場合は false に設定。

message

object

はい

role と content を含むメッセージオブジェクト

message.role

string

はい

メッセージ送信者の役割。'user' である必要があります。

message.content

string

はい

ユーザーの問い合わせ内容。

リクエスト例

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 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は現在$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]

スワップ意図トランザクション

エンドポイント

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

自然言語の取引意図を実行可能なスワップトランザクションペイロードに変換します。デフォルトで OKX DEX と互換性があります。

リクエストボディ

パラメータ

型

必須

説明

intent

string

はい

自然言語のスワップ意図（例: "swap 0.1 ETH to USDC"）

walletAddress

string

はい

ユーザーのウォレットアドレス（0x...）

chain

string

いいえ

チェーン名（例: "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

string

はい

取引シンボル（例: "BTC", "ETH", "SOL"）

style

string

いいえ

取引スタイル："scalping"、"day-trading"、または "swing-trading"

marginUSD

number

いいえ

USD建ての証拠金

leverage

number

いいえ

レバレッジ倍率（最大: 40）

strategy

string

いいえ

ストラテジーの種類（今後さらに戦略を追加予定）

リクエスト例

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で過熱していない強気の勢いを示している",
    "4時間足でMACDが強気のゴールデンクロスを示している",
    "出来高プロファイルが現在の水準での蓄積を示している"
  ],
  "risks": [
    "$100,000の心理的レジスタンスでの押し戻しの可能性",
    "今後のFRB会合に伴う高いボラティリティが予想される",
    "主要取引所のファンディング率が上昇傾向にある"
  ]
}

予測市場分析

エンドポイント

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

AIによる予測市場分析。予測市場イベントを分析し、各結果の確率推定と詳細な理由付けを提供します。

リクエストボディ

パラメータ

型

必須

説明

link

string

はい

予測市場ページのリンク（例: Polymarket のイベントURL）

mode

string

はい

チャットモード："fast" または "expert"

only_result

boolean

いいえ

理由付けなしで確率のみを返す

customPrompt

string

いいえ

分析を導くカスタム指示

リクエスト例

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": "最近の世論調査データと過去の傾向に基づくと、トランプは主要スイング州でわずかなリードを維持しています。しかし、レースは依然として非常に競争的で大きな不確実性が残っています..."
}

前へAPIリファレンス次へAPIリファレンス（x402）

最終更新 18 時間前

役に立ちましたか？

おはようございます

hashtag開発者向けAPI

hashtagDeveloper Chat

hashtagIntent to Swap Transaction

hashtagPerpetual Trading Suggestion

hashtagPrediction Market Analysis

hashtag開発者向けAPI

hashtagチャット

hashtagエンドポイント

hashtagリクエストボディ

hashtagリクエスト例

hashtagレスポンス

hashtag標準レスポンス（stream: false）

hashtagストリーミングレスポンス（stream: true）

hashtagスワップ意図トランザクション

hashtagエンドポイント

hashtagリクエストボディ

hashtagリクエスト例

hashtagレスポンス

hashtagパーペチュアル取引の提案

hashtagエンドポイント

hashtagリクエストボディ

hashtagリクエスト例

hashtagレスポンス

hashtag予測市場分析

hashtagエンドポイント

hashtagリクエストボディ

hashtagリクエスト例

hashtagレスポンス

開発者向けAPI

Developer Chat

Intent to Swap Transaction

Perpetual Trading Suggestion

Prediction Market Analysis

開発者向けAPI

チャット

エンドポイント

リクエストボディ

リクエスト例

レスポンス

標準レスポンス（stream: false）

ストリーミングレスポンス（stream: true）

スワップ意図トランザクション

エンドポイント

リクエストボディ

リクエスト例

レスポンス

パーペチュアル取引の提案

エンドポイント

リクエストボディ

リクエスト例

レスポンス

予測市場分析

エンドポイント

リクエストボディ

リクエスト例

レスポンス