> For the complete documentation index, see [llms.txt](https://minara.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://minara.ai/docs/minara-handbook/tr/islem/agent-api/api-key.md). # API Anahtarı API Anahtarı yöntemi şunlar için kullanılabilir: **Pro** ve **Partner** plan kullanıcıları. Anahtarları Minara profilinizden oluşturun ve bunları `Authorization` her isteğin üstbilgisine. *** ## Gereksinimler Minara Agent API yalnızca Pro ve Partner plan abonelerine özeldir. Ücretsiz 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 yenilediğinizde devam eder. *** ## Bir API anahtarı oluşturma 1. Şuraya gidin: **Hesap Profili** adresindeki [minara.ai](https://minara.ai). 2. Şunu seçin: **API Anahtarı** soldaki menüden sekmesini seçin ve tıklayın **Oluştur**.
API Key tab in Minara account profile showing Create button
3. Anahtarın kullanımını tanımlamak için bir ad ve açıklama girin.
Create API key dialog with name and description fields
4. Oluşturulduktan sonra API anahtarınız görüntülenir. Kopyalayın ve güvenli bir yerde saklayın — tekrar gösterilmeyecektir.
Newly created API key displayed for copying
*** ## API anahtarlarını yönetme | Eylem | Detaylar | | ------------------------- | --------------------------------------------------------------------------------------------------------- | | **Anahtarları görüntüle** | Anahtarlar yalnızca son 4 karakteri görünür olacak şekilde listelenir. Tam anahtarı görmek için tıklayın. | | **Anahtar sınırı** | Her Pro/Partner hesabı için en fazla 5 API anahtarı. | | **Anahtarı sil** | 2FA onayı gerektirir. Silme işlemi kalıcıdır. | *** ## Kimlik doğrulama API anahtarınızı şuna ekleyin: `Authorization` her isteğin başlığında: ``` Authorization: Bearer ``` **Örnek:** ```bash curl -H "Authorization: Bearer sk-minara-xxxxxxxx" \ https://api.minara.ai/v1/developer/chat ``` {% hint style="warning" %} API anahtarlarınızı parolalar gibi değerlendirin. Onları asla istemci tarafı kodda veya herkese açık depolarda ifşa etmeyin. {% endhint %} *** ## Faturalandırma Tüm API çağrıları tüketir **kredi** Minara hesabınızdaki. Krediler tükenirse, API istekleri yeniden yüklenene kadar duraklatılır. *** ## API referansı Temel URL: `https://api.minara.ai` ### Sohbet **`POST /v1/developer/chat`** ## Developer Chat > Developer chat endpoint supporting both streaming and non-streaming response modes. ```json {"openapi":"3.0.0","info":{"title":"Minara Agent API","version":"1.0"},"servers":[{"url":"https://api-developer.minara.ai"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API-KEY","description":"Format: Authorization: Bearer "}},"schemas":{"ChatRequest":{"type":"object","required":["mode","stream","message"],"properties":{"mode":{"type":"string","enum":["fast","expert"],"description":"Required. Model mode: 'fast' for quick responses, 'expert' for in-depth analysis."},"stream":{"type":"boolean","description":"Required. Set to true for streaming (SSE), false for standard JSON response."},"message":{"$ref":"#/components/schemas/Message"}}},"Message":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["user"],"description":"Required. Message sender role, must be 'user'."},"content":{"type":"string","description":"Required. The user's query content."}}},"ChatResponse":{"type":"object","properties":{"chatId":{"type":"string","description":"Unique conversation ID."},"messageId":{"type":"string","description":"Unique message ID for this response."},"content":{"type":"string","description":"The AI-generated response content."},"usage":{"type":"object","description":"Usage statistics for the request."}}}}},"paths":{"/v1/developer/chat":{"post":{"summary":"Developer Chat","description":"Developer chat endpoint supporting both streaming and non-streaming response modes.","operationId":"developerChat","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}},"text/event-stream":{"schema":{"type":"string","description":"Server-Sent Events (SSE) stream. Each event line starts with `data:`.\nThe final message is formed by concatenating chunk/delta content in order.\n"}}}},"401":{"description":"Unauthorized - Invalid or missing API key"}}}}}} ``` | Parametre | Tür | Gerekli | Açıklama | | ----------------- | ---- | ------- | ---------------------------------------------------------- | | `mode` | dize | Evet | `fast` hızlı yanıtlar için, `expert` ayrıntılı analiz için | | `stream` | bool | 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:** ```bash curl -X POST https://api.minara.ai/v1/developer/chat \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "mode": "fast", "stream": false, "message": { "role": "user", "content": "SOL'ün son fiyat hareketini analiz et." } }' ``` *** ### Swap işlemi niyeti **`POST /v1/developer/intent-to-swap-tx`** ## Intent to Swap Transaction > Convert natural language trading intent into an executable swap transaction payload. Compatible with OKX DEX by default. ```json {"openapi":"3.0.0","info":{"title":"Minara Agent API","version":"1.0"},"servers":[{"url":"https://api-developer.minara.ai"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API-KEY","description":"Format: Authorization: Bearer "}},"schemas":{"IntentToSwapRequest":{"type":"object","required":["intent","walletAddress"],"properties":{"intent":{"type":"string","description":"Required. Natural language swap intent (e.g., 'swap 0.1 ETH to USDC')."},"walletAddress":{"type":"string","description":"Required. User wallet address (0x...)."},"chain":{"type":"string","description":"Optional. Chain name (e.g., 'base', 'ethereum', 'bsc', 'arbitrum', 'optimism')."}}},"SwapTransactionResponse":{"type":"object","properties":{"intent":{"type":"object","description":"Parsed user intent","properties":{"chain":{"type":"string","description":"Chain name (e.g., 'base')."},"inputTokenAddress":{"type":"string","nullable":true,"description":"Input token contract address (null for native token)."},"inputTokenSymbol":{"type":"string","description":"Input token symbol (e.g., 'ETH')."},"outputTokenAddress":{"type":"string","description":"Output token contract address."},"outputTokenSymbol":{"type":"string","description":"Output token symbol (e.g., 'USDC')."},"amount":{"type":"string","description":"Token amount in wei/smallest unit."},"userWalletAddress":{"type":"string","description":"User's wallet address."}}},"quote":{"type":"object","description":"Swap quote and pricing information","properties":{"fromTokenAmount":{"type":"string","description":"Input token amount in smallest unit."},"toTokenAmount":{"type":"string","description":"Expected output token amount in smallest unit."},"estimatedGas":{"type":"string","description":"Estimated gas cost for the transaction."},"priceImpact":{"type":"string","description":"Price impact percentage."},"tradeFee":{"type":"string","description":"Trading fee amount."}}},"inputToken":{"type":"object","description":"Input token details","properties":{"address":{"type":"string","description":"Token contract address."},"symbol":{"type":"string","description":"Token symbol."},"decimals":{"type":"string","description":"Token decimals."},"unitPrice":{"type":"string","description":"Token unit price in USD."}}},"outputToken":{"type":"object","description":"Output token details","properties":{"address":{"type":"string","description":"Token contract address."},"symbol":{"type":"string","description":"Token symbol."},"decimals":{"type":"string","description":"Token decimals."},"unitPrice":{"type":"string","description":"Token unit price in USD."}}},"unsignedTx":{"type":"object","description":"Unsigned transaction ready to be signed and broadcasted","properties":{"chainType":{"type":"string","description":"Chain type (e.g., 'evm')."},"from":{"type":"string","description":"Sender address."},"to":{"type":"string","description":"Contract address to call."},"data":{"type":"string","description":"Encoded transaction data."},"value":{"type":"string","description":"Native token value to send (in wei)."},"gas":{"type":"string","description":"Gas limit."},"gasPrice":{"type":"string","description":"Gas price (legacy)."},"maxPriorityFeePerGas":{"type":"string","description":"Max priority fee per gas (EIP-1559)."}}},"approval":{"type":"object","description":"Token approval information (required for ERC20 token swaps)","properties":{"isRequired":{"type":"boolean","description":"Whether token approval is required before swap."},"tokenAddress":{"type":"string","description":"Token contract address that needs approval."},"spenderAddress":{"type":"string","description":"Spender address (DEX router) that needs approval."},"requiredAmount":{"type":"string","description":"Minimum token amount that needs to be approved."},"approveAmount":{"type":"string","description":"Recommended approval amount."},"currentAllowance":{"type":"string","description":"Current approved allowance for the spender."},"message":{"type":"string","description":"Human-readable approval status message."}}}}}}},"paths":{"/v1/developer/intent-to-swap-tx":{"post":{"summary":"Intent to Swap Transaction","description":"Convert natural language trading intent into an executable swap transaction payload. Compatible with OKX DEX by default.","operationId":"intentToSwap","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentToSwapRequest"}}}},"responses":{"200":{"description":"Swap transaction generated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapTransactionResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key"}}}}}} ``` Doğal dildeki işlem niyetini, varsayılan olarak OKX DEX ile uyumlu çalıştırılabilir bir swap işlem yüküne dönüştürün. | Parametre | Tür | Gerekli | Açıklama | | --------------- | ---- | ------- | --------------------------------------------------------- | | `intent` | dize | Evet | Doğal dilde swap niyeti (örn. "0.1 ETH'yi USDC'ye çevir") | | `walletAddress` | dize | Evet | Kullanıcı cüzdan adresi (0x...) | | `chain` | dize | Hayır | Zincir adı (örn. "base", "ethereum", "arbitrum") | **Örnek:** ```bash curl -X POST https://api.minara.ai/v1/developer/intent-to-swap-tx \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "intent": "0.1 ETH'yi USDC'ye çevir", "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1", "chain": "base" }' ``` *** ### Sürekli vadeli işlem önerisi **`POST /v1/developer/perp-trading-suggestion`** ## Perpetual Trading Suggestion > 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. ```json {"openapi":"3.0.0","info":{"title":"Minara Agent API","version":"1.0"},"servers":[{"url":"https://api-developer.minara.ai"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API-KEY","description":"Format: Authorization: Bearer "}},"schemas":{"PerpTradingRequest":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Required. Trading symbol (e.g., 'BTC', 'ETH', 'SOL')."},"style":{"type":"string","enum":["scalping","day-trading","swing-trading"],"default":"scalping","description":"Optional. Trading style: 'scalping', 'day-trading', or 'swing-trading'. Default: 'scalping'."},"marginUSD":{"type":"number","default":1000,"description":"Optional. Margin in USD. Default: 1000."},"leverage":{"type":"number","default":10,"minimum":1,"maximum":40,"description":"Optional. Leverage multiplier (max: 40). Default: 10."},"strategy":{"type":"string","default":"max-profit","description":"Optional. Strategy type. Default: 'max-profit'. More strategies coming soon."}}},"PerpTradingResponse":{"type":"object","properties":{"entryPrice":{"type":"number","description":"Recommended entry price."},"side":{"type":"string","enum":["long","short"],"description":"Trading side recommendation."},"stopLossPrice":{"type":"number","description":"Recommended stop loss price."},"takeProfitPrice":{"type":"number","description":"Recommended take profit price."},"confidence":{"type":"number","minimum":0,"maximum":100,"description":"Confidence score (0-100)."},"reasons":{"type":"array","items":{"type":"string"},"description":"Analysis reasons based on technical indicators."},"risks":{"type":"array","items":{"type":"string"},"description":"Risk factors to consider."}}}}},"paths":{"/v1/developer/perp-trading-suggestion":{"post":{"summary":"Perpetual Trading Suggestion","description":"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.","operationId":"perpTradingSuggestion","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpTradingRequest"}}}},"responses":{"200":{"description":"Perpetual trading suggestion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpTradingResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key"}}}}}} ``` Uzun/kısa önerileri, giriş, stop loss, take profit ve güven skoru içeren yapay zekâ destekli sürekli vadeli işlem önerileri alın. | Parametre | Tür | Gerekli | Açıklama | | ----------- | ---- | ------- | ------------------------------------------------- | | `symbol` | dize | Evet | İşlem sembolü (örn. "BTC", "ETH", "SOL") | | `style` | dize | Hayır | `skalplama`, `gün içi işlem`veya `salınım işlemi` | | `marginUSD` | sayı | Hayır | USD cinsinden marjin | | `leverage` | sayı | Hayır | Kaldıraç çarpanı (maks: 40) | | `strategy` | dize | Hayır | Strateji türü | **Örnek:** ```bash curl -X POST https://api.minara.ai/v1/developer/perp-trading-suggestion \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "symbol": "BTC", "style": "gün içi işlem", "marginUSD": 1000, "leverage": 10 }' ``` *** ### Tahmin piyasası analizi **`POST /v1/developer/prediction-market-ask`** ## Prediction Market Analysis > AI-powered prediction market analysis. Analyze prediction market events and get probability estimates for each outcome with detailed reasoning. ```json {"openapi":"3.0.0","info":{"title":"Minara Agent API","version":"1.0"},"servers":[{"url":"https://api-developer.minara.ai"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API-KEY","description":"Format: Authorization: Bearer "}},"schemas":{"PredictionMarketRequest":{"type":"object","required":["link","mode"],"properties":{"link":{"type":"string","description":"Required. Prediction market page link (e.g., Polymarket event URL)."},"mode":{"type":"string","enum":["fast","expert"],"description":"Required. Chat mode: 'fast' or 'expert'."},"only_result":{"type":"boolean","default":false,"description":"Optional. Only return prediction probabilities without reasoning. Default: false."},"customPrompt":{"type":"string","description":"Optional. Custom instructions to guide the analysis. Use this to specify focus areas, risk preferences, or analysis style."}}},"PredictionMarketResponse":{"type":"object","properties":{"predictions":{"type":"array","description":"Array of prediction outcomes. Each outcome represents an event option with its yes/no probabilities.","items":{"type":"object","properties":{"outcome":{"type":"string","description":"Outcome name (event option, e.g., candidate name, team name)."},"yesProb":{"type":"number","description":"Probability of YES for this outcome (0-1)."},"noProb":{"type":"number","description":"Probability of NO for this outcome (0-1)."}}}},"reasoning":{"type":"string","description":"AI reasoning and analysis (empty if only_result=true)."}}}}},"paths":{"/v1/developer/prediction-market-ask":{"post":{"summary":"Prediction Market Analysis","description":"AI-powered prediction market analysis. Analyze prediction market events and get probability estimates for each outcome with detailed reasoning.","operationId":"predictionMarketAsk","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionMarketRequest"}}}},"responses":{"200":{"description":"Prediction market analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionMarketResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key"}}}}}} ``` Tahmin piyasası sonuçları için yapay zekâ destekli olasılık tahminleri. | Parametre | Tür | Gerekli | Açıklama | | -------------- | ---- | ------- | ------------------------------------------------- | | `link` | dize | Evet | Tahmin piyasası etkinlik URL'si (örn. Polymarket) | | `mode` | dize | Evet | `fast` veya `expert` | | `only_result` | bool | Hayır | Yalnızca olasılıkları, gerekçe olmadan döndürün | | `customPrompt` | dize | Hayır | Analizi yönlendirmek için özel talimatlar | **Örnek:** ```bash curl -X POST https://api.minara.ai/v1/developer/prediction-market-ask \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "link": "https://polymarket.com/event/example", "mode": "fast" }' ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://minara.ai/docs/minara-handbook/tr/islem/agent-api/api-key.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.