minara

name	minara
description	Minara Agent API offers crypto trading analysis, swap intent conversion, perpetual trading suggestions, and prediction market analysis. Supports API Key and x402 (pay-per-use USDC). Use when this capability is needed.
metadata	{"author":"demerzels-lab"}

Minara API

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

Method	Base URL	Requires
API Key	https://api.minara.ai	MINARA_API_KEY (Pro/Partner at minara.ai)
x402	https://x402.minara.ai	EVM_PRIVATE_KEY + USDC wallet (pay-per-use, no subscription)

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.

Param	Type	Required	Description
mode	string	Yes	"fast" or "expert"
stream	boolean	Yes	false for JSON, true for SSE
message	object	Yes	{ "role": "user", "content": "..." }
chatId	string	No	Continue existing conversation

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).

Param	Type	Required	Description
intent	string	Yes	e.g. "swap 0.1 ETH to USDC"
walletAddress	string	Yes	0x... address
chain	string	No	"base", "ethereum", "bsc", "arbitrum", "optimism"

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.

Param	Type	Required	Description
symbol	string	Yes	e.g. "BTC", "ETH", "SOL"
style	string	No	"scalping", "day-trading", "swing-trading" (default: scalping)
marginUSD	number	No	Default 1000
leverage	number	No	1–40, default 10
strategy	string	No	Default "max-profit"

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.

Param	Type	Required	Description
link	string	Yes	Event URL (e.g. Polymarket)
mode	string	Yes	"fast" or "expert"
only_result	boolean	No	true = probabilities only, no reasoning
customPrompt	string	No	Custom analysis instructions

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.

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.