API Reference (API Key)

Technical specifications for the Minara Agent API endpoints.

Developer API

The core endpoint for interacting with Minara's conversational AI.

Developer Chat

post

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

Authorizations

AuthorizationstringRequired

Format: Authorization: Bearer <YOUR_API_KEY>

Body

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

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.

Authorizations

AuthorizationstringRequired

Format: Authorization: Bearer <YOUR_API_KEY>

Body

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

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

AuthorizationstringRequired

Format: Authorization: Bearer <YOUR_API_KEY>

Body

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

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

AuthorizationstringRequired

Format: Authorization: Bearer <YOUR_API_KEY>

Body

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

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

Developer API

Chat

Endpoint

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

Request Body

Parameter

Type

Required

Description

mode

string

Yes

Model mode: 'fast' for quick responses, 'expert' for in-depth analysis.

stream

boolean

Yes

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

message

object

Yes

Message object with role and content

message.role

string

Yes

Message sender role, must be 'user'.

message.content

string

Yes

The user's query content.

Example Request

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": "Analyze the recent price action of SOL and give me a trading suggestion."
    }
  }'

Responses

Standard Response (stream: false)

Returns a JSON object with the complete response.

{
  "chatId": "chat_abc123",
  "messageId": "msg_def456",
  "content": "SOL is currently trading at $187.50, up 4.2% in the last 24 hours. Based on the 4H chart, it has broken above the key resistance at $185 with strong volume. RSI is at 62, indicating bullish momentum without being overbought. \n\nSuggestion: Consider a long position with entry around $186-188, take profit at $195, and stop loss at $180...",
  "usage": {}
}

Streaming Response (stream: true)

Returns Content-Type: text/event-stream using 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 is currently trading at $187.50, up 4.2% in the last 24 hours.\n"},"finish_reason":null}]}

data: {"chatId":"chat_abc123","messageId":"msg_def456","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Based on the 4H chart, it has broken above the key resistance at $185 with strong volume.\n"},"finish_reason":null}]}

data: [DONE]

Intent to Swap Transaction

Endpoint

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

Convert natural language trading intent into an executable swap transaction payload. Compatible with OKX DEX by default.

Request Body

Parameter

Type

Required

Description

intent

string

Yes

Natural language swap intent (e.g., "swap 0.1 ETH to USDC")

walletAddress

string

Yes

User wallet address (0x...)

chain

string

Chain name (e.g., "base", "ethereum", "bsc", "arbitrum", "optimism")

Example Request

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

Response

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

Perpetual Trading Suggestion

Endpoint

POST https://api-developer.minara.ai/v1/developer/perp-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.

Request Body

Parameter

Type

Required

Description

symbol

string

Yes

Trading symbol (e.g., "BTC", "ETH", "SOL")

style

string

Trading style: "scalping", "day-trading", or "swing-trading"

marginUSD

number

Margin in USD

leverage

number

Leverage multiplier (max: 40)

strategy

string

Strategy type (more strategies coming soon)

Example Request

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

Response

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

Endpoint

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

AI-powered prediction market analysis. Analyze prediction market events and get probability estimates for each outcome with detailed reasoning.

Request Body

Parameter

Type

Required

Description

link

string

Yes

Prediction market page link (e.g., Polymarket event URL)

mode

string

Yes

Chat mode: "fast" or "expert"

only_result

boolean

Only return prediction probabilities without reasoning

customPrompt

string

Custom instructions to guide the analysis

Example Request

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": "Focus on recent news and sentiment analysis. Be more conservative in probability estimates."
  }'

Response

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

PreviousAPI Reference NextAPI Reference (x402)

Last updated 8 hours ago

Was this helpful?

Good night

hashtagDeveloper API

hashtagDeveloper Chat

hashtagIntent to Swap Transaction

hashtagPerpetual Trading Suggestion

hashtagPrediction Market Analysis

hashtagDeveloper API

hashtagChat

hashtagEndpoint

hashtagRequest Body

hashtagExample Request

hashtagResponses

hashtagStandard Response (stream: false)

hashtagStreaming Response (stream: true)

hashtagIntent to Swap Transaction

hashtagEndpoint

hashtagRequest Body

hashtagExample Request

hashtagResponse

hashtagPerpetual Trading Suggestion

hashtagEndpoint

hashtagRequest Body

hashtagExample Request

hashtagResponse

hashtagPrediction Market Analysis

hashtagEndpoint

hashtagRequest Body

hashtagExample Request

hashtagResponse

Developer API

Developer Chat

Intent to Swap Transaction

Perpetual Trading Suggestion

Prediction Market Analysis

Developer API

Chat

Endpoint

Request Body

Example Request

Responses

Standard Response (stream: false)

Streaming Response (stream: true)

Intent to Swap Transaction

Endpoint

Request Body

Example Request

Response

Perpetual Trading Suggestion

Endpoint

Request Body

Example Request

Response

Prediction Market Analysis

Endpoint

Request Body

Example Request

Response