API Referansı (API Anahtarı)

Minara Agent API uç noktaları için teknik özellikler.

Geliştirici API'si

Minara'nın konuşma tabanlı yapay zekasıyla etkileşim kurmak için ana uç nokta.

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

Geliştirici API'si

Sohbet

Uç nokta

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

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
mod	string	Evet	Model modu: hızlı yanıtlar için 'fast', derinlemesine analiz için 'expert'.
stream	boolean	Evet	Akış (SSE) için true, standart JSON yanıtı için false olarak ayarlayın.
mesaj	object	Evet	rol ve içerik içeren mesaj nesnesi
message.role	string	Evet	Mesaj gönderenin rolü, 'user' olmalıdır.
message.content	string	Evet	Kullanıcının sorgu içeriği.

Örnek İstek

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'ün son fiyat hareketini analiz et ve bana bir işlem önerisi ver."
    }
  }'

Yanıtlar

Standart Yanıt (stream: false)

Tam yanıtla birlikte bir JSON nesnesi döner.

{
  "chatId": "chat_abc123",
  "messageId": "msg_def456",
  "content": "SOL şu anda $187.50 seviyesinden işlem görüyor, son 24 saatte %4.2 yükseldi. 4H grafiğe göre, güçlü hacimle $185 ana direncinin üzerinde kırılım yaptı. RSI 62 seviyesinde, aşırı alım olmadan boğa momentumu gösteriyor. \n\nÖneri: $186-188 civarında giriş ile uzun pozisyon düşünün, kar al $195, zarar durdur $180...",
  "usage": {}
}

Akışlı Yanıt (stream: true)

Döner Content-Type: text/event-stream Server-Sent Events (SSE) kullanılarak.

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 şu anda $187.50 seviyesinden işlem görüyor, son 24 saatte %4.2 yükseldi.\n"},"finish_reason":null}]}

data: {"chatId":"chat_abc123","messageId":"msg_def456","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"4H grafiğe göre, güçlü hacimle $185 ana direncinin üzerinde kırılım yaptı.\n"},"finish_reason":null}]}

data: [DONE]

---

Swap İşlemi Niyeti

Uç nokta

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

Doğal dildeki işlem niyetini yürütülebilir bir swap işlem yüküne dönüştürür. Varsayılan olarak OKX DEX ile uyumludur.

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
niyet	string	Evet	Doğal dil swap niyeti (örn. "0.1 ETH'yi USDC'ye takas et")
cüzdanAdresi	string	Evet	Kullanıcı cüzdan adresi (0x...)
zincir	string	Hayır	Zincir adı (örn. "base", "ethereum", "bsc", "arbitrum", "optimism")

Örnek İstek

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

Yanıt

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

---

Sürekli Vadeli İşlem Önerisi

Uç nokta

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

Uzun/kısa önerileri, giriş fiyatı, stop loss, kar al seviyeleri ve kapsamlı piyasa analizine dayalı güven skorunu içeren yapay zeka destekli perpetual (sürekli vadeli) işlem önerileri alın.

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
sembol	string	Evet	İşlem sembolü (örn. "BTC", "ETH", "SOL")
stil	string	Hayır	İşlem stili: "scalping", "day-trading" veya "swing-trading"
marginUSD	number	Hayır	USD cinsinden marjin
kaldıraç	number	Hayır	Kaldıraç çarpanı (maks: 40)
strateji	string	Hayır	Strateji türü (daha fazla strateji yakında eklenecek)

Örnek İstek

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

Yanıt

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC güçlü hacimle $97,500 ana direncinin üzerine çıktı",
    "RSI 62, aşırı alım olmadan boğa momentumu gösteriyor",
    "MACD 4H zaman aralığında boğa kesişimi gösteriyor",
    "Hacim profili mevcut seviyelerde birikim gösteriyor"
  ],
  "riskler": [
    "$100,000 psikolojik direncinde olası geri çekilme",
    "Yaklaşan Fed toplantısı etrafında yüksek volatilite bekleniyor",
    "Büyük borsalardaki fonlama oranları yükseliş eğiliminde"
  ]
}

---

Tahmin Piyasası Analizi

Uç nokta

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

Yapay zeka destekli tahmin pazarı analizi. Tahmin pazarı etkinliklerini analiz edin ve her sonuç için ayrıntılı gerekçelendirme ile olasılık tahminleri alın.

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
bağlantı	string	Evet	Tahmin pazarı sayfa bağlantısı (örn. Polymarket etkinlik URL'si)
mod	string	Evet	Sohbet modu: "fast" veya "expert"
sadece_sonuc	boolean	Hayır	Gerekçelendirme olmadan yalnızca tahmin olasılıklarını döndürür
özelleştirilmişİstek	string	Hayır	Analizi yönlendirmek için özel talimatlar

Örnek İstek

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": "Son haberler ve duygu analizine odaklan. Olasılık tahminlerinde daha temkinli ol."
  }'

Yanıt

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "Son anket verileri ve tarihsel eğilimlere dayanarak, Trump kilit salınım eyaletlerinde hafif bir önde gidiyor. Ancak yarış önemli belirsizliklerle hala oldukça rekabetçi..."
}