API Anahtarı

API Anahtarı yöntemi şu kullanıcılar için kullanılabilir: Pro ve Partner plan kullanıcıları. Anahtarları Minara profilinizden oluşturun ve bunları Authorization başlığına ekleyin.

---

Gereksinimler

Minara Agent API, yalnızca Pro ve Partner plan abonelerine sunulmaktadır. Ücretsiz bir plandaysanız, yükseltme istemini görmek için profilinizdeki API sekmesine gidin.

Aboneliğinizi düşürürseniz, tüm etkin API anahtarları otomatik olarak duraklatılır ve aboneliğinizi yenilediğinizde yeniden etkinleşir.

---

API anahtarı oluşturma

1. Şuraya gidin: Hesap Profili adresinde minara.ai.

2. Şunu seçin: API Anahtarı sekmesini sol menüden açın ve tıklayın Oluştur.

1. Anahtarın kullanımını tanımlamak için bir ad ve açıklama girin.

1. Oluşturulduktan sonra API anahtarınız görüntülenir. Kopyalayın ve güvenli bir yerde saklayın — bir daha gösterilmeyecektir.

---

API anahtarlarını yönetme

Eylem	Ayrıntılar
Anahtarları görüntüle	Anahtarlar yalnızca son 4 karakter görünür şekilde listelenir. Tam anahtarı göstermek için tıklayın.
Anahtar limiti	Pro/Partner hesabı başına en fazla 5 API anahtarı.
Anahtarı sil	2FA onayı gerektirir. Silme işlemi kalıcıdır.

---

Kimlik doğrulama

API anahtarınızı her isteğin Authorization başlığına ekleyin:

Authorization: Bearer <YOUR_API_KEY>

Örnek:

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

API anahtarlarınızı parolalar gibi ele alın. Onları asla istemci tarafı kodda veya herkese açık depolarda ifşa etmeyin.

---

Faturalandırma

Tüm API çağrıları Minara hesabınızdaki kredileri tüketir. Kredileriniz biterse, API istekleri yenilenene kadar duraklatılır.

---

API referansı

Temel URL: https://api.minara.ai

Sohbet

POST /v1/developer/chat

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

chatIdstringOptional

Unique conversation ID.

messageIdstringOptional

Unique message ID for this response.

contentstringOptional

The AI-generated response content.

usageobjectOptional

Usage statistics for the request.

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

Parametre	Tür	Gerekli	Açıklama
mod	dize	Evet	hızlı hızlı yanıtlar için, uzman derinlemesine analiz için
akış	boolean	Evet	true SSE akışı için, false standart JSON için
message.role	dize	Evet	olmalıdır user
message.content	dize	Evet	Sorgu içeriği

Örnek:

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'un son fiyat hareketini analiz edin." }
  }'

---

Takasa dönüşüm işlemi amacı

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

Doğal dildeki işlem niyetini, varsayılan olarak OKX DEX ile uyumlu, yürütülebilir bir takas işlemi yüküne dönüştürün.

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

Örnek:

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'yi USDC'ye takas et",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
    "chain": "base"
  }'

---

Sürekli vadeli işlem önerisi

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

Uzun/kısa önerileri, giriş, zarar durdur, kar al ve güven skoru içeren yapay zekâ destekli sürekli vadeli işlem önerileri alın.

Parametre	Tür	Gerekli	Açıklama
sembol	dize	Evet	İşlem sembolü (örn. "BTC", "ETH", "SOL")
stil	dize	Hayır	scalping, günlük işlem, veya swing trading
marginUSD	sayı	Hayır	USD cinsinden teminat
kaldıraç	sayı	Hayır	Kaldıraç çarpanı (maks: 40)
strateji	dize	Hayır	Strateji türü

Örnek:

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

---

Tahmin piyasası analizi

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

Tahmin piyasası sonuçları için yapay zekâ destekli olasılık tahminleri.

Parametre	Tür	Gerekli	Açıklama
bağlantı	dize	Evet	Tahmin piyasası etkinlik URL'si (örn. Polymarket)
mod	dize	Evet	hızlı veya uzman
yalnızca_sonuç	boolean	Hayır	Yalnızca olasılıkları, gerekçe olmadan döndürün
özelKomut	dize	Hayır	Analizi yönlendirmek için özel talimatlar

Örnek:

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