Minara

Minara API

Call the Minara Agent API for crypto trading assistance. Two auth options:

Use API Key when MINARA_API_KEY is set; otherwise use x402 when EVM_PRIVATE_KEY is available.

Endpoints

1. Chat

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

General-purpose chat for trading analysis, market insights, and questions.

Response: { chatId, messageId, content, usage }

2. Intent to Swap Transaction

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

Convert natural language swap intent to an executable transaction payload (OKX DEX compatible).

Response: { transaction: { chain, inputTokenAddress, inputTokenSymbol, outputTokenAddress, outputTokenSymbol, amount, amountPercentage, slippagePercent } }

3. Perpetual Trading Suggestion

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

Get perp trading suggestions: side, entry, stop loss, take profit, confidence.

Response: { entryPrice, side, stopLossPrice, takeProfitPrice, confidence, reasons, risks }

4. Prediction Market Analysis

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

Analyze prediction market events (e.g. Polymarket) and get probability estimates.

Response: { predictions: [{ outcome, yesProb, noProb }], reasoning }

Usage

API Key (api.minara.ai)

Use fetch or HTTP client:

• URL: endpoint above
• Method: POST
• Headers: Authorization: Bearer ${process.env.MINARA_API_KEY}, Content-Type: application/json
• Body: JSON object per endpoint spec

x402 (x402.minara.ai)

Pay-per-use with USDC. No subscription. See Getting Started by x402.

Option A: x402 SDK (recommended)

Node.js example—SDK handles payment challenges automatically:

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(
  process.env.EVM_PRIVATE_KEY as `0x${string}`
);
const client = new x402Client();
registerExactEvmScheme(client, { signer });
const fetchWithPayment = wrapFetchWithPayment(fetch, client);

const res = await fetchWithPayment("https://x402.minara.ai/x402/chat", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ userQuery: "What is the current price of BTC?" }),
});
const data = await res.json();

Dependencies: @x402/fetch, @x402/evm, viem. Solana: add @x402/svm.

x402 Chat endpoint (differs from API Key):

• POST https://x402.minara.ai/x402/chat
• Body: { "userQuery": "..." } (no mode/stream/message/chatId)
• Response: { content }

Chain-specific: https://x402.minara.ai/x402/solana/chat, https://x402.minara.ai/x402/polygon/chat

Option B: Manual 402 flow

1. Request → 402 with payment instructions (amount, recipient, chain)
2. Send USDC to recipient
3. Retry with x-payment-response header containing payment proof

Config

~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "minara": {
        "enabled": true,
        "apiKey": "YOUR_MINARA_API_KEY",
        "env": { "EVM_PRIVATE_KEY": "0x..." }
      }
    }
  }
}

• API Key: set apiKey or MINARA_API_KEY in env.
• x402: set env.EVM_PRIVATE_KEY or EVM_PRIVATE_KEY in env. Wallet must hold USDC. Sandboxed: use agents.defaults.sandbox.docker.env.