API 참조 (API 키)

Minara 에이전트 API 엔드포인트에 대한 기술 사양입니다.

개발자 API

Minara의 대화형 AI와 상호작용하기 위한 핵심 엔드포인트입니다.

Developer Chat

post

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

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:

streambooleanRequired

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

Responses

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.

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

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

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.

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

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	불리언	예	스트리밍(SSE)을 위해 true로 설정하고, 표준 JSON 응답을 위해 false로 설정합니다.
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 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	문자열	예	자연어 스왑 의도 (예: "0.1 ETH를 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": "승인 한도가 0x57df6092665eb6058DE53939612413ff4B09114E의 spender에 대해 충분합니다"
  }
}

---

영구(Perpetual) 거래 제안

엔드포인트

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

롱/숏 추천, 진입가, 손절, 익절 수준 및 포괄적인 시장 분석에 기반한 신뢰도 점수를 포함한 AI 기반 영구 선물 거래 제안을 제공합니다.

요청 본문

매개변수	형식	필수	설명
symbol	문자열	예	거래 심볼 (예: "BTC", "ETH", "SOL")
style	문자열	아니오	거래 스타일: "scalping", "day-trading", 또는 "swing-trading"
marginUSD	숫자	아니오	USD 단위의 증거금
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": "최근 여론 조사 데이터와 역사적 추세를 기반으로 볼 때, 트럼프는 핵심 스윙 주들에서 근소한 우위를 유지하고 있습니다. 그러나 경합은 매우 치열하며 상당한 불확실성이 남아 있습니다..."
}