# About Minara Minara is an AI trading platform built on Hyperliquid. Ask questions, get real-time analysis, and trade crypto, stocks, and commodities in one interface.
FeatureGeneric Chatbots like ChatGPT and GrokMinara AI
Accurate, real-time crypto & stocks data❌✅
Trusted & actionable financial insightsWeakStrong
Precise market sentiment detectionWeakStrong
Built-in crypto wallet❌✅
Vibe trading with stablecoins❌✅
Gasless on-chain executions❌✅
Creating agentic financial workflows without coding❌✅
## What is Minara? Minara combines a Web3-native AI model with a built-in custodial wallet, real-time market data, and a trading execution layer. You can ask market questions, get analysis backed by live on-chain and price data, run automated strategies, and execute trades without switching between tools. The platform runs on Hyperliquid for perpetual trading and supports spot trading across Solana, Ethereum, Base, BNB Chain, Avalanche, Arbitrum, Optimism, and Polygon.
## Who is Minara for? Minara is for active traders and crypto participants who want faster, more informed decisions. Whether you are monitoring market sentiment on Bitcoin (BTC) or Ethereum (ETH), running a backtest on a Solana (SOL) strategy, setting up a grid bot on gold (XAU), or just asking "should I long BTC right now?" — Minara gives you a structured answer with data behind it. It is also useful for people newer to trading who want to act on market signals without building complex tooling from scratch. ## What Minara includes **Web3-native AI model** Trained on domain-specific financial and crypto data, with access to over 50 integrated data providers covering price, on-chain metrics, sentiment, DeFi, and macro signals. **Real-time data integration** * Finance: transactions, stocks, crypto, DeFi, liquidations, VC and project data * Audience: wallet holders, smart money, social identities, PnL, relationships * Sentiment: news, X posts, Fear & Greed index, macro signals, policy headlines **Trading execution** Trade perpetuals on Hyperliquid via AI Copilot (manual execution with AI signals) or Autopilot (fully automated). Supported assets include Bitcoin (BTC), Ethereum (ETH), Solana (SOL), gold (XAU), silver, crude oil, and tokenized US stocks such as Apple (AAPL), Tesla (TSLA), NVIDIA (NVDA), Amazon (AMZN), and Microsoft (MSFT). Spot trade across 8 chains directly from chat. **Strategy Studio** Write and backtest algorithmic strategies using Pine Runtime, Minara's TypeScript DSL. Deploy strategies directly to Autopilot. **Agent workflows** Build trading and monitoring workflows from templates — copy trading, DCA, price alerts — without writing code. # Create your account Access requires an invitation code. Here's how to register. **No code?** See [Get an invitation code](broken://pages/yjXbu2ozwlxEIBD9IrRL) to get one first. *** ## How to register **1. Go to minara.ai** and click **Launch App** or **Ask Minara**.
**2. Enter your invitation code.** Type in your invite code when prompted. Once it's accepted, your account is active.
If you don't have a code yet, you can join the waitlist for code distribution from the same screen. # Deposit funds This guide will show you how to deposit **USDC** in three different ways: using a credit card, withdrawing from a CEX, or transferring from another crypto wallet. {% embed url="" %} ## Deposit with a credit card ⚠️ *Note: Minara does not operate these services (deposit with a credit card)* and isn’t able to step in on their behalf. *We only aggregate third-party OTC providers.* ### Deposit via Alchemy Pay #### 1. Select Alchemy Pay First, click on the **Deposit** button at the top right, then select **Alchemy Pay**.
#### 2. Select Fiat and Input Amount Select the fiat currency you wish to pay with, then input the amount of USDC you wish to buy.
#### 3. Confirm Email Confirm your Email Address and enter the verification code sent to your email.
#### 4. Fill in Payment Method and KYC Choose your payment method, input your credit card or Google Pay information, and complete KYC. Once verified and the payment is completed, you will receive your tokens. | Choose Payment Method | Fill in Information | KYC | | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | | | | | If you have any questions, please contact Alchemy Pay support: *** ### Deposit via Banxa Pay #### 1. Select Banxa Pay First, click on the **Deposit** button at the top right, then select **Banxa Pay**.
#### 2. Select Fiat and Input Amount Select the fiat currency you wish to pay with. In the red box, input the amount and token you wish to buy (e.g., USDC), and select Solona chain.
3. **KYC and Pay** Then, fill out your personal details for KYC. After verification and payment, you will receive your tokens. | KYC Step 1 | KYC Step 2 | KYC Step 3 | | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | | | | | If you have any questions, please contact Banxa Pay support: *** ## Deposit from CEXs #### **1. Prepare Your Exchange Account** Log in to your CEX account (e.g., Binance, OKX, Coinbase) and ensure you have the crypto asset you want to transfer. #### **2. Click "Deposit" button** Visit Minara and log in to your account. Click the **“Deposit”** button at the top right corner, and select "On-chain Deposit".
**3. Choose Token and Network** Select the blockchain network you want to use for the deposit. Minara will generate a wallet address for the selected network.
#### **4. Withdraw from the CEX** Go to your exchange's **Withdraw/Send** section. * Paste the deposit address from Minara * Select the same token and network as shown on Minara * Enter the amount and confirm the withdrawal Once the transaction is confirmed on-chain, your funds will appear in your Minara account. *** ## Deposit from another crypto wallet #### **1. Prepare Your Wallet** Make sure you have a crypto wallet with sufficient funds and access to the correct blockchain network. #### **2. Click "Deposit" button** Visit Minara and log in to your account. Click the **“Deposit”** button at the top right corner, and select "On-chain Deposit".
**3. Select the Token and Network** Choose the token you want to deposit (e.g., USDC, ETH) and the corresponding blockchain network (e.g., Ethereum, Arbitrum, BNB Chain).
#### **4. Send the Funds** Copy the deposit address provided by Minara and send the tokens from your wallet. * Double-check the token type and network * Confirm the transaction in your wallet * Wait for on-chain confirmation (usually a few minutes) **Once confirmed, your balance will be updated in Minara.** # Withdraw # Research and analysis The Minara chat input has four modes, selectable from the toolbar beneath the text field. Each mode changes what Minara does with your question.
Minara chat interface showing the four mode icons in the input toolbar
*** ## Chat **Tooltip:** Get instant financial insight. The default mode. Ask any question about crypto, stocks, commodities, or macro. Minara queries its data sources in real time and responds in conversational format. Use this for price checks, quick analysis, trade signals, on-chain lookups, and follow-up questions. Common examples: checking BTC price and on-chain metrics, reviewing ETH funding rates, looking up SOL whale activity, or asking about gold (XAU) macro positioning.
Chat mode tooltip showing Get instant financial insight
**Speed toggle**: in Chat mode, you can switch between two response depths using the toggle on the right side of the input: * **Fast**: clear, concise answers with fewer reasoning steps. Good for quick checks. * **Quality**: thorough explanations with structured insights. Use for complex analysis or trade decisions.
Fast and Quality response depth toggle showing descriptions for each option
*** ## Deep Research **Tooltip:** Generate structured reports on complex topics. Deep Research runs a multi-stage research workflow instead of responding immediately. Minara decomposes your question into tasks, queries multiple data sources in parallel, cross-validates findings, and produces a structured report with charts, citations, and an executive summary.
Deep Research mode tooltip showing Generate structured reports on complex topics
Use Deep Research when you need a shareable, source-backed output rather than a quick answer. For example: a fund memo on Ethereum's competitive positioning, a macro analysis of gold versus Bitcoin in a risk-off environment, or a sector overview of AI-related stocks like NVIDIA (NVDA), Microsoft (MSFT), and Amazon (AMZN). Output is downloadable as PDF or Word. **When to use Deep Research vs Chat:** | | Chat | Deep Research | | ------------- | --------------------------- | -------------------------------- | | Response time | Seconds | 1–3 minutes | | Output format | Conversational | Structured report with sections | | Best for | Quick decisions, follow-ups | In-depth analysis, documentation | | Downloadable | No | Yes (PDF / Word) | *** ## Data Visualization **Tooltip:** Data in tables and visuals, on your command. Data Visualization mode outputs structured tables and charts alongside analysis. When you activate it, you can select up to 5 preferred chart types before sending your question. Minara will try to produce your preferred chart types from the data.
Data Visualization mode active state showing sample prompts and Preferred Charts selector with Lines, Bars, Pie, Candles, and Funnel options
**Available chart types:** Lines, Bars, Pie, Candles, Funnel, Scatter, Heatmap, Radar, Calendar, Treemap, Sankey, Sunburst, Network, Gauge. **When to use Data Visualization:** * Comparing multiple assets across a time range, for example BTC versus ETH versus SOL over 30 days * Visualizing whale or holder distributions for a specific token * Building a portfolio breakdown by chain or asset * Tracking wallet activity with charts * Comparing stock performance across sectors (AAPL, TSLA, NVDA, AMZN, MSFT) * Turning a research output into a visual you can share {% hint style="info" %} Data Visualization queries typically cost more credits than standard Chat responses. The cost scales with the number of assets, the date range, and the number of charts rendered. Start with a table-only request if you want to control credit spend, then add charts in a follow-up. {% endhint %} *** ## Upload images or files The chain icon in the toolbar opens a file picker. You can attach images, Excel/CSV files, or PDFs alongside your question. Minara reads the content and incorporates it into its response, for example analyzing a chart screenshot you annotated, reviewing a trading journal in Excel, or summarizing a whitepaper PDF. Up to 5 files, 10 MB each. See [Multimodal input](/docs/reference/multimodal-input) for details and examples. # What to ask Minara Minara's chat handles research, analysis, and trade decisions across crypto, stocks, commodities, and macro. This page shows concrete examples by trader type — the kind of questions Minara answers well, and what you get back.
Minara chat interface showing Trending, Crypto, Stock, Macro, Sentiment, Workflow, and Learn tabs
The tabs at the bottom of the chat input (Trending, Crypto, Stock, Macro, Sentiment, Workflow, Learn) show ready-made starting points. You can also type anything directly. *** ## Crypto traders **Token research and fundamentals** ``` Summarize Hyperliquid's key competitors and differentiators. ``` ``` Is the token distribution structure of Kaito reasonable? ``` ``` How does $PENDLE's yield-trading mechanism work in DeFi? ``` Minara returns competitive landscape, tokenomics analysis, and mechanism breakdowns sourced from on-chain data, project documentation, and market data providers. **On-chain and whale activity** ``` Is BTC still a good buy after the recent rally to $81k? Show me on-chain data and whale activity. ```
Minara pulls live on-chain data and returns: entry zone, price targets with standard deviation levels, stop loss, and an assessment of institutional accumulation vs. distribution from exchange flows. **DeFi and yield** ``` Which DeFi protocols on Solana have the highest real yield right now? ``` ``` Compare Pendle's fixed-yield pools for ETH — which maturity gives the best risk-adjusted return? ``` ``` What are the top pools on Uniswap v3 by fee APR this week? ```
**Meme coins and alpha** ``` Spotted any early Alpha projects with asymmetric upside? ``` ``` Which coins are institutions quietly paying attention to or allocating into? ``` ``` Any coins worth buying right now? Drop me 5 solid picks. ```
*** ## Stock traders **Earnings analysis** ``` What does NVDA's latest earnings tell me about the AI hardware cycle? Is it still worth holding? ```
Minara returns a structured earnings breakdown — quarterly and annual metrics side by side — followed by a qualitative read on what the numbers mean for the sector. For NVDA: data center revenue hit $39.1B with 73% YoY growth, net margin expanded to 63.1%. ``` What does $JPM's Q1 earnings beat signal about banking sector health? ``` ``` Summarize the key takeaways from $AAPL's latest earnings report. ``` ``` What risks does $META's $145B capex plan pose to its profitability outlook? ```
**Sector and momentum** ``` What is driving $FLEX's post-earnings surge and cloud spin-off announcement? ``` ``` Which S&P 500 sectors are showing the strongest institutional inflows this week? ``` ``` Compare the 30-day performance of semiconductors vs. software vs. cloud infrastructure. ```
*** ## Macro and cross-asset traders **Multi-asset positioning** ``` With the Fed holding rates and tariff uncertainty, how should I position between gold, BTC, and Nasdaq right now? ```
Minara reads current macro data — Fed meeting minutes, inflation figures, GDP prints — and returns an asset-by-asset positioning table. In this example: Fed locked at 3.75% with hawkish tilt, inflation reaccelerated to 3.5% YoY, stagflation risk flagged, Gold overweight. **Rates and policy** ``` How do rising Treasury yields typically affect $ETH valuations? ``` ``` What does the latest Fed policy statement imply for risk assets? ``` ``` How does a global risk-off environment affect $COIN stock performance? ```
**Geopolitical risk** ``` Which assets are most impacted by the US's new tariff policy? ``` ``` How do geopolitical tensions in the Middle East affect $ETH price? ```
*** ## Sentiment and social analysis **KOL and narrative tracking** ``` What narratives is @loomdart pushing about $SOL lately? ``` ``` Summarize @cz_binance's recent opinion on $BNB. ``` ``` Which KOLs on X are most bullish on AI tokens this week? ```
Minara monitors X in real time and summarizes what influential accounts are saying about specific assets (useful for understanding narrative shifts before they show up in price). **Fear, greed, and crowd positioning** ``` What is the fear and greed sentiment for $LINK on X today? ``` ``` What is the current X sentiment around $ETH after the latest upgrade? ``` ``` Is the hype around $PEPE fading or growing on X? ```
*** ## Institutional and quantitative use **Portfolio-level analysis** ``` Analyze trader James Wynn's on-chain strategy and positioning motives. ``` ``` Show me the top 15 ETH whale addresses by holdings and visualize their distribution. ``` ``` Which smart money wallets are accumulating $SOL in the last 72 hours? ```
**Deep research** For structured research reports with sources, charts, and executive summaries, activate **Deep Research** mode from the chat toolbar. Examples: ``` Provide a comprehensive market analysis of Ethereum Layer-2 solutions. ``` ``` Research the competitive positioning of Hyperliquid vs. dYdX vs. GMX for a fund memo. ``` Deep Research generates a downloadable report in PDF or Word format. See [Research and analysis](/docs/chat/deep-research) for how it works. {% hint style="info" %} Minara draws on 50+ data providers in real time — on-chain transactions, price data, X sentiment, DeFi metrics, macro indicators, and equity fundamentals. The more specific your question (asset name, chain, timeframe, what you want to decide), the more useful the answer. {% endhint %}
# Crypto picks Crypto Picks is an AI-curated watchlist of tokens with short-term directional signals. Minara analyzes each token continuously and presents its current outlook (bullish or bearish), a price target, and the data behind the call. You can ask follow-up questions or trade directly from the board. View the current board:
{% hint style="info" %} **Disclaimer:** Rankings and signals are generated by Minara AI based on aggregated market data. They are for informational purposes only and do not constitute financial advice. {% endhint %} *** ## What the board covers Crypto Picks focuses on short-term market monitoring (12-hour to 1-week horizon). It does not cover long-term valuation or fundamental analysis. The board has two sides: * **Bullish Board** — tokens with upward potential in the near term * **Bearish Board** — tokens with increasing downside risk in the near term Each side is ranked and refreshed continuously based on a multi-factor model covering volatility, liquidity, technical signals, and sentiment. *** ## How tokens are selected Each token on the board passed a data-driven selection process that evaluates: **Market and technical signals** * 30-day rolling volatility and maximum drawdown * Trading volume, liquidity, and turnover rate * Momentum indicators: MA, EMA, RSI, ATR, funding-rate shifts, structural breakouts **On-chain and capital flow signals** * Large wallet transactions and address cluster behavior * Net fund movement between CEXs and on-chain wallets (accumulation vs. distribution) * Long-term holder counts and active address changes **Fundamental and news factors** * Ecosystem activity, development progress, major upgrades, tokenomics changes * News sentiment and market reactions to policy or macro events Each token receives a directional probability (bullish or bearish) and a confidence score reflecting Minara's conviction in the call. *** ## Reading the board Each board item shows standardized fields so you can judge direction, timing, and risk at a glance.
| Visual & interaction | What it shows | | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![](/files/RWADvb1HWukEfS1naoth) Hover to view | **Volatility** — a standardized classification derived from volatility, market cap, and liquidity | | ![](/files/tYbpC3UKs5Rn9yEH9sxA) | 1. **Current price and 24h change** — latest price and percentage change in the past 24 hours. 2. **Comparison with initial tracked price** — green arrow means current price is above the price when the token was added; red arrow means below | | ![](/files/AuFMBb3l8ORp1ZKKhmak) Hover on \[Price] section | **Initial tracked price** — price when the token was added. **Highest since listing** — peak price during the tracking window vs. initial. **Lowest since listing** — lowest price during the tracking window vs. initial. **Tracking since** — timestamp of initial inclusion | | ![](/files/eu4XnluS42TJ1rEV34N9) Hover on green progress bar | 1. **Target price** — short-horizon price objective predicted by Minara (12h–1w); targets are dynamic and may be revised as the trend develops. 2. **Progress** — how far price has moved toward the target from initial level; stays at zero if the move goes against the position, locks at 100% once the target is reached | | ![](/files/WwJ1gMIyNF7pA5nXe28G) Hover to view full content | **Why Bullish / Why Bearish** — AI-generated rationale combining technical signals (MA, EMA, RSI, ATR, funding rate), on-chain and flow data (whale transactions, CEX in/out, holder changes), and fundamental drivers (project updates, tokenomics, macro events) | | ![](/files/1he4SEoLH6X1cN2S2nwn) Hover for options | 1. **Follow-up questions** — three suggested questions based on the token's rationale, or ask Minara anything directly. 2. **Trade** — on-chain trading is supported for major tokens through Minara's integrated wallet; perpetual trading is coming soon | *** ## Refresh schedule and review logic | Type | Trigger | Action | | --------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Scheduled refresh** | Every 4 hours | Recompute direction, target, and confidence using latest market, on-chain, and news data. Extend targets if the trend is intact and momentum persists. | | **Immediate review** | Price deviates 20% or more against the prediction | Reassess direction. If direction flips, the token is removed and the removal is logged in History. | *** ## History
History shows tokens removed from either board within the past 7 days. For each removed token: * **Status at removal:** price and target at the time of removal * **Reason for removal:** AI-provided explanation — common reasons are target reached, trend ended, reversal detected, or a material adverse/positive event * **Since-listing performance:** highest and lowest price vs. initial tracked price * **Tracking window:** start and end timestamps **Re-entry:** a previously removed token can reappear if a new valid setup forms. It is treated as a fresh listing — new tracked price, new target, new confidence, new tracking start time. At market turning points, a token may be removed from one board and simultaneously added to the other. *** ## Risk preference setting You can adjust your **Risk Preference** to filter the tokens shown: * **Low** — large-cap, lower-volatility tokens * **Medium** — balanced exposure * **High** — smaller-cap, high-volatility tokens with stronger short-term potential This setting reorders tokens within each board according to their risk-return characteristics. # News feed **News Feed** is Minara's curated information system that aggregates, analyzes, and summarizes high-value finance-related news in real time. See the real time news feed here:
It takes fragmented reporting from global media and organizes it into structured, verifiable events. Each event covers what happened, why it matters, and the market impact. The system continuously monitors multiple trusted sources, removes redundant or repetitive reports, and organizes news into events with context, relevance, and traceable updates. *** ### Core capabilities
CapabilityDescription
Multi-source aggregationCollects verified news from hundreds of global crypto, finance, and macroeconomic outlets.
AI summarizationConverts multi-source reports into concise, factual summaries (≈5 min read) with structured sections ("What Happened", "Why It Matters", "Market Impact", etc.).
Event groupingDetects and merges duplicate reports that describe the same incident, and links sequential developments into a continuous event timeline.
Impact on assetsIdentifies which assets, tokens, sectors, or projects are directly affected, and classifies them as bullish or bearish, with an explanation section titled Impact on Assets added to the article.
Scoring & prioritizationEach event receives an internal relevance score based on its importance, scope, expected duration of influence and significance to broader macroeconomic trends.
"Key Concept" moduleWhen an article focuses on a specific project or concept, a Key Concept section is added to briefly introduce it (e.g., "About Bybit", "About Lightning Network").
Follow-up interactionUsers can ask follow-up questions about the news. Pre-generated follow-up questions are also provided for users to easily explore event context, market effects, or implications.
Source transparencyEach summary cites aggregated sources, ensuring verifiability and transparency.
*** ### How it works #### Source aggregation Discover News continuously collects information from verified crypto and financial outlets across multiple formats, including RSS feeds, APIs, and platform announcements. Incoming articles are automatically **normalized**, **timestamped**, and **scored** to ensure only credible and relevant stories enter the analysis pipeline. > Minara gathers content from more than 20 primary media sources, such as Cointelegraph, Coindesk, Decrypt, BWEnews, and selected announcements from exchanges and projects. *** #### Event generation When a new article is ingested, Minara determines whether it should: * **Merge** with an existing event (if multiple sources report the *same incident*), or * **Create** a new independent event that may be linked to existing events as related (if the story represents a follow-up, consequence, or reaction to an existing event). Each event is anchored to the timestamp of its earliest reported article, ensuring chronological consistency. *** #### Asset & sector mapping Minara performs **entity extraction** and **context tagging** to map which cryptos, stocks, projects, or sectors are directly or indirectly affected by each event. Each identified entity receives a sentiment label: * 🟢 **Bullish:** positive catalyst or favorable implication. * 🔴 **Bearish:** negative catalyst or adverse development. This classification enables users to instantly see how macro events or project-specific incidents propagate across the broader market. *** #### Scoring & prioritization Every event is assigned a **composite score** reflecting its relevance and impact: * **Importance:** magnitude or market sensitivity of the event. * **Scope:** the breadth of affected entities or sectors. * **Long-term Impact**: estimated duration of influence. * **Significance in Macroeconomics:** the extent to which the event affects key macroeconomic indicators or policy expectations. For Discover News Feed, low-scoring events are filtered out to reduce noise and improve overall content quality. *** #### Summarization Once event grouping and score filtering are complete, Minara summarizes the combined sources into a **structured report** with distinct sections: 1. **Summary:** a concise overview of the incident. 2. **Sources:** list of all verified sources included. 3. **What Happened:** factual reconstruction of the event. 4. **Why It Matters:** context and implications for the market. 5. **Market Impact:** short-term and structural effects on assets. 6. **Key Concepts:** concise explanation of key terms or entities mentioned. All text follows a neutral, journalistic tone — avoiding speculation or promotional phrasing. *** #### Updates & revisions Event content dynamically evolves as new reports emerge: * **Breaking Period (0–24h):** frequent refreshes as more outlets cover the story. * **Stable Period (24h–3d):** new relevant developments are linked as related instead of merged. * **Archived Period (>3d):** event frozen for historical reference but remains visible. *** #### Follow-up interaction Every event supports user interaction through the **Follow-Up** feature: * Minara auto-suggests questions relevant to the story (e.g., "How does this affect BTC?", "Is this connected to regulation?", "What could happen next?"). * Users may also input custom questions to explore deeper context under each event. In the follow-up chat, users can click the title to view the original news directly without leaving the chat.
*** ### Upcoming improvements Planned additions include: * **Personalization:** delivering user-tailored insights based on profile data, composite scores, and topic relevance; * **Topic filtering:** allowing users to browse and track news by topics such as *DeFi*, *RWA*, *Stablecoins*, *Infrastructure*, and more. Additional features such as search and flexible feed views will also be introduced. # Copilot Trading Copilot is an AI assistant that analyzes market conditions and generates structured trade signals for perpetual trading on Hyperliquid. You review the signal (entry price, take-profit, and stop-loss) and execute with one click. You remain in control of every trade. Access Trading Copilot at: [copilot.minara.ai](https://copilot.minara.ai) *** ## 1. How Copilot generates signals When you click **Ask Long** or **Ask Short**, Copilot evaluates the following inputs and produces a structured trade plan: **Market structure and price action** * Multi-timeframe candlestick data matched to your selected trading style * Trend direction, volatility structure, key price levels * Technical indicators: EMA, RSI, MACD **Order book and liquidity** * Real-time order book depth * Bid/ask imbalance and recent trade flow **Derivatives market signals** * Funding rate history and direction * Open interest changes * Positioning dynamics from derivatives data **Risk filtering** Before presenting a signal, Copilot filters out setups with unfavorable risk-to-reward ratios, insufficient stop-loss buffers, or structurally invalid risk parameters. The output includes: * Trade direction: Long, Short, or Neutral * Suggested entry price, take-profit (TP), and stop-loss (SL) * Brief explanation of the signal rationale
*** ## 2. Signal parameters you control **Trading style**: determines the timeframe Copilot focuses on: * `Scalping`: 3-minute chart, short in-and-out trades * `Day`: 15-minute chart, same-day entries and exits * `Swing`: 4-hour chart, positions held days to weeks **Strategy**: determines the type of setup Copilot looks for: * `Max Gain`: high reward-to-risk setups with strong backtest upside; fewer trades, larger moves * `Max Win Rate` *(coming soon)*: higher-probability setups with more flexible entry conditions **Initial margin**: your default margin amount for quick orders. Does not affect signal output. *** ## 3. Supported assets Copilot generates signals for all perpetuals available on Hyperliquid. This includes: * Crypto: Bitcoin (BTC), Ethereum (ETH), Solana (SOL), and hundreds of other tokens * Commodities: gold (XAU), silver (SILVER), crude oil * Stocks: Apple (AAPL), Tesla (TSLA), NVIDIA (NVDA), Amazon (AMZN), Microsoft (MSFT), and other major US equities *** ## 4. Infrastructure Minara does not provide liquidity or act as a counterparty. All perpetual trades execute on Hyperliquid. Pricing, leverage, funding rates, and liquidity are fully Hyperliquid's. Minara is the AI interface and execution layer on top. *** ## 5. Deposit and transfer funds Before trading, you need funds in your Minara Perps Wallet. Direct deposits to the Perps Wallet are not yet supported; you must go through the Spot Wallet first. **Step 1: Deposit into your Minara Spot Wallet**
**Step 2: Transfer from Spot Wallet to Perps Wallet**
**Transfer rules:** * Minimum transfer into Perps Wallet: 10 USDT * Minimum transfer out of Perps Wallet: more than 1 USDT * Hyperliquid charges a 1 USDT fee on withdrawals from the Perps Wallet * Network fees apply on transfer (on-chain transaction) *** ## 6. Executing a trade Once Copilot generates a signal, it pre-fills a limit order with the suggested entry, take-profit, and stop-loss. Before confirming, you can adjust: * Leverage * Initial margin Place the order with one click. Manual market and limit orders are also available for advanced users. *** ## 7. Managing open positions **Close all positions**: closes all open positions at market price (requires confirmation). **Manual close**: close individual positions via market or limit order. **Set take-profit and stop-loss on open positions:** Go to Trade > Positions, select a position, and click "Add":
Set TP and/or SL values, optionally add split targets, then confirm:
Your take-profit and stop-loss are now active on the position:
Realized PnL updates immediately after execution. *** ## 8. Open order management You can cancel individual pending orders or use **Cancel All Orders** to clear everything at once. *** ## 9. Margin mode Copilot supports both margin modes provided by Hyperliquid: * `Cross margin`: all positions share the same margin balance * `Isolated margin`: margin is isolated per position Switch margin modes directly in the trading interface. # Autopilot Autopilot executes trading strategies on your behalf, 24 hours a day. Once you select a strategy and define your trading scope, the AI opens positions, manages take-profit and stop-loss orders, trails stops as conditions change, and closes or reverses positions when signals shift, without requiring manual input. You can override or stop Autopilot at any time. {% hint style="info" %} Autopilot is built around three principles: * Every automated action is visible and explainable * You can override at any time * Manual actions that conflict with AI execution are handled explicitly in-product {% endhint %} *** ## How to access Autopilot Path: [Trade](https://copilot.minara.ai/) > Perps > Autopilot {% columns %} {% column %} ![](/files/HuP4hm2a7wh2Mjn2XWo7) Copilot Mode {% endcolumn %} {% column %} ![](/files/erzwFNUyEzHqtWFNeLBs)Click Autopilot Tab {% endcolumn %} {% column %} ![](/files/JxN0RZkFwqdEL8DmmOX4)Start Autopilot {% endcolumn %} {% endcolumns %} Autopilot is available on paid plans. If your subscription expires while Autopilot is running, you can continue viewing and operating the panel, but you cannot start a new Autopilot session until your subscription is reactivated. *** ## Available strategies ### Sharpe Guard 2.0 Type: Trend-following (15-minute chart) A trend-following strategy optimized for Sharpe Ratio. It combines fast stop-loss execution, multi-layer trend confirmation, and trailing exits to improve consistency and control drawdowns. Version 2.0 adds a **market regime detection** layer that classifies prevailing market conditions (trending vs. ranging, risk-on vs. risk-off) and adjusts entry sizing and exit behavior accordingly. This reduces whipsaws in choppy markets and increases conviction during clear trend conditions. Read more: [Sharpe Guard 2.0 announcement](https://x.com/minara/status/2030132735910785335) ### Classic Futures Grid Type: Range-bound A long/short grid strategy for sideways markets. Autopilot suggests grid parameters (grid amount, funding, upper and lower bounds) based on current market data. Once started, the grid engine places and manages orders automatically. Futures Grid cannot run when there are open positions in the wallet. All existing open orders are canceled on start. ### Supertrend Monitor (legacy — deprecated) {% hint style="info" %} Supertrend Monitor has been retired. Existing users should migrate to Sharpe Guard 2.0, which supersedes it with broader regime-aware logic. This section is kept for historical reference only. {% endhint %} ### Custom strategies from Strategy Studio Autopilot also supports custom strategies built in [Strategy Studio](/docs/trade/strategy-studio). Once you deploy a strategy from Studio, it appears in the Autopilot strategy list alongside official strategies and runs under the same execution and risk-control framework. *** ## Trading scope When you start Autopilot, you define which assets it is authorized to manage. The strategy supports crypto perpetuals such as Bitcoin (BTC), Ethereum (ETH), and Solana (SOL), as well as commodity perpetuals including gold (XAU) and silver. Stock perpetuals such as Apple (AAPL), Tesla (TSLA), and NVIDIA (NVDA) can also be included depending on the active strategy. Autopilot only opens positions within your authorized scope. Assets outside that scope are not touched. *** ## What Autopilot does automatically For standard AI strategies (Sharpe Guard 2.0): * Opens positions when entry signals fire within your authorized trading scope * Places take-profit and stop-loss orders on every position * Trails the stop-loss as the market moves in your favor * Closes the position at market price if technical indicators shift rapidly * Reverses the position when conditions warrant, sizing the new position using the same rules as any new entry * Applies global risk controls, including maximum drawdown limits * Exits and sends you a notification if safety thresholds are triggered *** ## Wallet setup **Minimum funds required** Autopilot requires at least **$100** in available funds to operate. For Futures Grid, the minimum is calculated dynamically based on the grid parameters.

Real-time available funds shown here

{% hint style="info" %} **Available funds = Perps Wallet equity − occupied funds** Occupied funds = Autopilot margin in use + worst-case estimated loss of any eligible user positions (calculated from stop-loss trigger price, including estimated slippage and fees) {% endhint %} If you have no open positions, all equity is available. If you hold an existing position, the stop-loss-bounded risk of that position is reserved, and only the remaining equity is available for new Autopilot positions. **Depositing funds** Deposit USDC on Arbitrum directly into the Perps Wallet. Other chains and assets are not supported. Minimum deposit: 10 USDC (after gas fees). {% hint style="info" %} If you deposit less than 10 USDC (for example, 5 USDC), the funds remain pending until your cumulative deposits reach 10 USDC or more. At that point, the full amount is credited to the Perps Wallet. {% endhint %} **Margin mode requirements** Autopilot requires cross margin for all managed assets. Autopilot cannot start if: * You have any isolated margin position, or * You hold a position outside the strategy's trading scope For example: if the active strategy covers BTC, ETH, and SOL, but you hold an open HYPE position, you must close HYPE before starting Autopilot. *** ## Starting Autopilot
On first enablement: 1. Autopilot checks eligibility and minimum available funds 2. You configure the **Trading Scope**: the assets you authorize Autopilot to manage 3. You confirm risk settings and start On later enablement attempts, Autopilot reuses your last configuration. When multiple assets trigger entry signals simultaneously and the account supports fewer concurrent positions than available signals, Autopilot opens positions in asset priority order. All existing open orders are canceled when Autopilot starts. *** ## Manual actions and overrides Autopilot treats manual intervention as an intentional override and prompts you on how to proceed. **Transferring funds out of Perps Wallet**: stops Autopilot automatically. **Transferring funds into Perps Wallet**: does not stop Autopilot; increases available funds. **Closing positions manually**: you can close any position at any time. **TP/SL orders**: you cannot cancel Autopilot-managed TP/SL orders while Autopilot is active. *** ## Safety exits Autopilot stops automatically under two conditions: **Initial equity drawdown limit reached** (if you enabled this setting): all managed positions are closed at market price, all pending orders are canceled, Autopilot stops, and you receive an email notification. **Account equity falls to $5 or below**: same result. Positions are closed, orders are canceled, Autopilot stops, and an email is sent. *** ## Risk note {% hint style="info" %} Perpetual trading involves significant market risk. Autopilot enforces trading discipline through mandatory TP/SL and trailing stop-loss management, but it does not eliminate market risk and does not guarantee profits. {% endhint %} # Strategy Studio Strategy Studio is where you build, backtest, and deploy algorithmic trading strategies. Strategies are written in Pine Runtime, Minara's TypeScript DSL, and run against historical market data before going live. A deployed strategy executes automatically, opening and closing positions according to your code. Find it at `/app/trade/strategy-studio`. ## Left sidebar The sidebar shows two sections: * **Deployed**: strategies currently running live. Each deployed strategy shows its live APY and the asset it trades. * **Drafts**: strategies you're editing or have not yet deployed. Changes to a draft never affect a deployed strategy. Click any entry to open it in the editor. ## Create a new strategy Click **New Strategy** in the top-right corner. Two options: * **Describe your idea in chat**: type what you want the strategy to do in plain language. Minara generates the Pine Runtime code. This is what Minara calls "Vibe Trading": you describe the logic, the AI writes the code. * **Write code directly**: start from a blank editor or an existing template and write Pine Runtime yourself. Either way, the strategy opens in draft state. Nothing runs until you deploy. ### Creating from a description Be specific about four things: asset, timeframe, entry condition, exit condition. For example: > "Go long BTC on the 1-hour chart when the 9-EMA crosses above the 21-EMA. Exit when RSI exceeds 70 or price drops 3% from entry." Other examples to get started: > "Short ETH on the 15-minute chart when MACD crosses below signal and price is below the 200-EMA." > "Go long SOL when the daily RSI crosses above 40 coming from oversold. Exit at 10% gain or 5% loss." > "Long NVDA perpetual on the 4-hour chart when price breaks above the 20-day high with above-average volume." After Minara generates the code, open the **Code** tab to verify the logic matches your intent. Ask follow-up questions to adjust any part of it before running a backtest. ## Editor tabs | Tab | What it shows | | -------- | ------------------------------------------------- | | Code | Pine Runtime source code for your strategy | | Metrics | Backtest performance summary | | Trades | Individual trade log from the backtest | | Paper | Live paper trading (no real capital) | | Optimize | Parameter sweep tool for finding optimal settings | ## Run a backtest In the **Code** tab, set your date range and asset, then click **Run Backtest**. Results appear in the **Metrics** tab. Backtests are supported for all perpetual assets available on Hyperliquid, including Bitcoin (BTC), Ethereum (ETH), Solana (SOL), gold (XAU), silver, and stock perpetuals such as Apple (AAPL), Tesla (TSLA), and NVIDIA (NVDA). ### What each metric means | Metric | What it tells you | | ------------- | --------------------------------------------------------------------------- | | Total Return | Percentage gain or loss over the backtest period | | Max Drawdown | Largest peak-to-trough decline; measures worst-case loss | | Win Rate | Percentage of trades that closed in profit | | Profit Factor | Gross profit divided by gross loss; above 1.0 means the strategy made money | | Sharpe Ratio | Return per unit of risk; above 1.0 is generally acceptable | | Sortino Ratio | Like Sharpe but only penalizes downside volatility | {% hint style="info" %} A strong backtest does not guarantee live performance. Cold-start bias and overfitting are common. Use the **Paper** tab to validate the strategy in live conditions before deploying real capital. {% endhint %} ## Deploy a strategy When you're satisfied with the backtest and paper results, click **Deploy**. This locks the current version of your code into a running strategy. The deployed strategy appears under **Deployed** in the sidebar with a live APY counter. Two things to know: 1. **Editing a draft does not affect the live strategy.** The deployed version runs the code that was current at deployment time. To update a live strategy, you must deploy again. 2. **You cannot stop a deployed strategy without closing its positions.** Stopping it closes all open positions it manages. ## Monitor a deployed strategy Click a deployed strategy to view: * **APY**: annualized return since deployment * **Positions**: current open positions and their unrealized P\&L * **Trade log**: every entry and exit, with timestamps and realized P\&L {% hint style="info" %} APY is calculated from the strategy's realized P\&L since deployment. It resets if you stop and redeploy the strategy. {% endhint %} # Prediction Market Prediction Market Copilot is Minara's AI-powered signal engine for Hyperliquid HIP-4 binary prediction markets. It analyzes multi-timeframe technical data, estimates the probability that a price condition will be met at settlement, and compares that estimate against the current market-implied probability to identify contracts where the expected value is positive. **What you can do with Prediction Market Copilot:** * Get YES, NO, or WAIT signals for all active HIP-4 contracts in one view * See AI-estimated probability versus market-implied probability side by side, with edge percentage * Review expected value per dollar risked before committing to a position * Execute trades directly from the signal card with preset or custom sizes * Track open prediction market positions through to automatic settlement *** ## What is Prediction Market Copilot? Hyperliquid HIP-4 defines on-chain binary prediction contracts. Each contract asks a single question about a price event: will asset X be above price Y at time Z? YES tokens settle at $1.00 if the condition is met. NO tokens settle at $1.00 if it is not. The YES token price represents the market's collective implied probability. YES at 0.65 means the market assigns a 65% chance to the condition being met. Prediction Market Copilot adds a second probability estimate to this: the AI probability, derived from technical analysis across five timeframes. The gap between the AI probability and the market price — measured in percentage points — is the edge. Positive edge on the YES side signals a YES recommendation. Positive edge on the NO side signals NO. When expected value is negative on both sides, Copilot recommends WAIT. The core logic is expected value, not direction: ``` EV(YES) = p_AI × (1 − yes_price) − (1 − p_AI) × yes_price EV(NO) = (1 − p_AI) × yes_price − p_AI × (1 − yes_price) ``` A Copilot signal fires when EV on one side is positive. The signal does not mean "BTC will go up." It means "at the current price, this contract has a positive expected return given the AI's probability estimate." *** ## Who is Prediction Market Copilot For? | User Type | Experience Level | How to Use | | ---------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------ | | **Beginners** | New to prediction markets | Follow Copilot signals directly; use $10–$50 preset sizes; read risk notes on each card | | **Traders** | Familiar with binary outcomes and EV | Use signals as a first filter; review TA reasoning before execution; size by conviction | | **Developers / Power Users** | Quantitative or automated workflows | Access structured signal output via API; run position sizing logic on raw probability data | *** ## How to Access Direct URL: `https://minara.ai/app/prediction-markets` In-app navigation: **Copilot** → **Prediction Markets** tab A connected Hyperliquid wallet with USDC balance is required for trade execution. Signal viewing requires no balance. *** ## Reading the Signal List The signal list displays all active HIP-4 contracts. Each row contains: | Field | Description | | ------------------ | --------------------------------------------------------------------- | | **Contract** | Asset, target price, and settlement timestamp | | **Time remaining** | Countdown to settlement | | **Direction** | YES (green) / NO (red) / WAIT (gray) | | **Edge** | AI probability minus market-implied probability, in percentage points | | **Confidence** | HIGH / MEDIUM / LOW, based on EV magnitude | The list defaults to sorting by edge size descending. Contracts with the highest expected value appear first. *** ## Understanding the Signal Card Tapping any contract in the signal list opens its signal card. | Section | Content | | -------------------------- | ------------------------------------------------------------------------------ | | **Direction badge** | YES / NO / WAIT with HIGH / MEDIUM / LOW confidence | | **Probability comparison** | AI probability vs market-implied probability (YES price) | | **Edge** | Gap between the two, in percentage points | | **Expected value** | EV per $1 risked (e.g., "+$0.14") | | **TA reasoning** | Three data-specific bullets (max 20 words each) | | **Risk note** | The single most likely factor that could invalidate the call | | **Execution** | Preset sizes ($10 / $50 / $100 / $500) + custom; win/loss preview updates live | *** ## How AI Probability Works Copilot generates an AI probability estimate through the following pipeline: **Step 1 — Technical analysis.** For each contract, Copilot reads K-line data across five timeframes: 1m, 5m, 15m, 1h, and 4h. It computes: | Indicator | Parameters | | -------------------- | ---------------------------------- | | RSI | 14-period | | MACD | 12 / 26 / 9 | | Bollinger Bands | 20-period, 2 std dev | | EMA | 20, 50, 200 | | ATR | 14-period | | Support / Resistance | Local swing highs/lows | | Funding rate | Current Hyperliquid perpetual rate | **Step 2 — Timeframe weighting.** The timeframe closest to the settlement window carries more weight. A 2-hour contract emphasizes 5m and 15m data. A 24-hour contract emphasizes 1h and 4h. **Step 3 — Probability output.** The model synthesizes all inputs into a single probability estimate. When signals conflict or the chart is ambiguous, the estimate moves toward 0.50. Copilot does not produce artificially confident numbers. *** ## Expected Value Calculation | Variable | Definition | | ----------- | ------------------------------------------------------ | | `p_AI` | AI-estimated probability that the condition is met | | `yes_price` | Current YES token price (= market-implied probability) | | `no_price` | 1 − yes\_price | ``` EV(YES) = p_AI × (1 − yes_price) − (1 − p_AI) × yes_price EV(NO) = (1 − p_AI) × yes_price − p_AI × (1 − yes_price) ``` Copilot recommends YES when EV(YES) > 0, NO when EV(NO) > 0. Confidence tiers: | EV | Confidence | | --------------------------------------- | ---------- | | > 0.10 (> 10 percentage points of edge) | HIGH | | 0.02–0.10 | MEDIUM | | < 0.02 or negative | WAIT | *** ## Hard Rule Overrides Three scenarios override the EV calculation: **Short settlement + favorable position.** When settlement is within 30 minutes and BTC is already more than 0.5% above the target price, Copilot recommends YES directly. Reversing a 0.5% gap in under 30 minutes requires sustained selling pressure that is statistically unlikely in most conditions. **Long settlement + extreme pricing.** When settlement is more than 20 hours away and either YES or NO is priced below 0.40, Copilot recommends the cheap side regardless of directional view. The time window is long enough that extreme initial pricing typically represents mispricing. **Overpriced outcomes.** When either side is priced above 0.90 with more than one hour remaining, Copilot recommends WAIT. The apparent winner is already priced in, and the remaining edge does not justify the position. *** ## Trade Execution From the signal card: 1. Confirm the recommended direction (YES or NO button is highlighted). 2. Select a size — $10, $50, $100, $500, or enter a custom amount. 3. Review the win/loss dollar preview. 4. Swipe to confirm. The order routes to Hyperliquid through your connected wallet. Settlement is automatic at the contract's expiry time. Winning tokens credit your account at $1.00 each. Losing tokens expire at $0. *** ## Position Tracking The **Positions** tab shows all open prediction market contracts: | Field | Description | | --------------- | -------------------------------------- | | Contract | Target price + settlement timestamp | | Side | YES or NO | | Size | Number of tokens | | Current price | Live YES/NO token price | | Unrealized P\&L | Marked-to-market against current price | | Time remaining | Countdown to settlement | *** ## What Prediction Market Copilot Can and Cannot Do ### What you can define * Which contract to trade and which side (or follow Copilot's recommendation) * Position size per contract * Whether to act on HIGH, MEDIUM, or LOW confidence signals ### What the platform controls * AI probability estimation methodology and model parameters * EV calculation formula and confidence tier thresholds * Hard rule overrides for short/long settlement scenarios * Settlement execution (automatic at Hyperliquid contract expiry) ### Current limitations * BTC HIP-4 contracts only at launch. ETH and other assets to follow. * No integration with scheduled macro data (CPI, FOMC, etc.). The TA pipeline reads price and volume only. * No cross-contract portfolio optimization. Each signal is evaluated independently. * AI probability calibration is a live process. Cold-start accuracy is lower than steady-state accuracy. Historical win rates by confidence tier will be published as data accumulates. * Minimum trade size and market liquidity on HIP-4 contracts may limit execution on very small orders. *** ## Tips for Better Results 1. Check the risk note on every signal card before executing. It names the specific factor most likely to invalidate the call. 2. Prioritize HIGH confidence signals over MEDIUM when capital is limited. Edge magnitude correlates with historical accuracy in well-calibrated models. 3. Avoid placing positions when the time remaining is less than 5 minutes. Liquidity is typically thin near settlement. 4. Track your own win rate by confidence tier and compare against Copilot's displayed accuracy. Divergences are informative. 5. Use WAIT recommendations actively. Sitting out a contract with no edge is the correct decision, not a missed opportunity. 6. Do not size up dramatically on a single contract because the EV looks large. EV is a per-trade statistical expectation, not a single-trade guarantee. 7. Review the multi-timeframe TA summary in the detailed analysis view for contracts where you are near your trade size limit. *** ## Disclaimers * Historical backtest performance, where displayed, is not indicative of future results. * All trading involves risk. Only trade with funds you can afford to lose. * Prediction Market Copilot provides AI-generated signals for informational purposes only. These signals do not constitute financial or investment advice. * All perpetual and prediction market trades are executed on Hyperliquid. Minara does not act as a counterparty or liquidity provider. * AI probability estimates are based on technical analysis and may not account for fundamental, macroeconomic, or news-driven events. * The user maintains full control of all positions at all times. Copilot does not execute trades autonomously. * Model calibration improves over time. Early accuracy statistics should be treated as preliminary. # Prediction Markets Minara's Prediction Markets feature gives you access to Hyperliquid's binary crypto prediction markets through Minara's trading interface. You can trade Yes or No positions on short-term price events — for example, "Will BTC be above $80,354 at 2:00 PM?" — with AI analysis signals displayed alongside your order panel to help inform your decision. For trading fees, please refer to [Trading fees](/docs/trade/trading-fees) . Try it at: [prediction.minara.ai](https://prediction.minara.aihttps/minara.ai/app/trade/prediction)
## What is Prediction Markets? [Hyperliquid](https://app.hyperliquid.xyz/trade) runs on-chain binary prediction contracts under its Outcome market. Each contract asks a single question about a crypto price event. Yes tokens settle at $1.00 if the condition is met; No tokens settle at $1.00 if it is not. The Yes token price represents the market's current implied probability. Minara integrates these markets into its trading interface, adding an AI analysis layer that shows confidence scores, edge signals, and estimated profit per $100 for each open contract. **What you can do with Prediction Markets:** * Browse active Hyperliquid Outcome markets within Minara * View AI analysis for each market: confidence level, Edge %, and Est. profit per $100 * Trade Yes or No positions using USDH * Analyze market price action on a TradingView candlestick chart * Use quick-fill amounts ($10, $50, $100, $500, $1,000) or enter a custom size * Ask Minara for reasoning behind any AI signal without leaving the screen *** ## Understanding the AI Prediction Panel The left panel on the Prediction screen shows AI analysis for active Hyperliquid Outcome markets. Each card surfaces a market with Minara's AI assessment.
FieldWhat it means
Market titleThe binary question (e.g., "BTC above 80354 on May 10 at 2:00 PM?")
ConfidenceAI confidence in its signal — High or Medium
DirectionWhich side the AI signal favors — Buy YES or Buy NO
Edge %AI's estimate of statistical advantage at current market prices. Positive Edge means the AI sees value on the signaled side; negative means the market price is against the thesis
Est. ProfitEstimated profit per $100 invested if the position resolves correctly at current odds
OddsCurrent market odds for the signaled side (e.g., 2.04x)
The AI panel is a decision-support tool. All trading decisions and order submissions are made by you. > **Note:** Edge % is a model estimate based on price data and current market conditions. It is not a prediction of outcome. Review each card on its own merits before trading. *** ## Reading the Market The top bar for each selected market displays:
FieldWhat it shows
BTC Price / CountdownCurrent BTC spot price and time remaining until settlement
% ChanceCurrent market-implied probability of the Yes outcome
Price (Yes)Current cost of one Yes share (equals the implied probability)
24h ChangePrice change in the Yes token over the past 24 hours
24h VolumeTotal trading volume across both sides
The center panel shows a TradingView candlestick chart of the prediction market contract's Yes token price history — not the underlying BTC price. Use this to assess how market sentiment has shifted over the contract's life.
*** ## Placing a Trade {% stepper %} {% step %} **Select a Market** Click any card in the AI Prediction panel, or use the market selector dropdown at the top of the chart area to browse all active Hyperliquid Outcome markets.
{% endstep %} {% step %} **Ask Minara** Minara consultancy panel is right at your left and you can click "Ask Minara" to analyze current risks and profits.
{% endstep %} {% step %} **Choose a Side** In the right panel, select **Buy** or **Sell**, then choose **Yes** or **No**.
SideWhen
YesYou believe the price condition will be met at settlement
NoYou believe the price condition will not be met
Current implied probability for each side is displayed as a percentage (e.g., Yes 49% / No 51%). {% hint style="info" %} You will need sufficient USDH in your wallet before you can trade outcomes. {% endhint %}
{% endstep %} {% step %} **Set Your Amount** Enter a USDH amount or use the quick-fill buttons ($10, $50, $100, $500, $1,000). Review the order details before confirming:
FieldWhat it shows
SlippageEstimated price impact at your order size
Avg PriceExpected average fill price per share
SharesNumber of shares your amount buys at current odds
Potential ReturnDollar gain if your position resolves correctly
> **Review before submitting.** Slippage can be significant on lower-volume contracts. Potential Return is calculated at current market odds and may shift before settlement.
{% endstep %} {% step %} **Confirm the Order** Click **Buy Yes** or **Buy No** to submit. Trades settle in USDH. Your open position appears in the **Outcomes** tab at the bottom of the screen. {% endstep %} {% endstepper %} ## Monitoring Positions The bottom panel has four tabs:
TabWhat it shows
OutcomesYour active prediction market positions and current marked-to-market value
Open OrdersOrders submitted but not yet filled
Trade HistoryCompleted trades with entry price, exit, and PnL
Order HistoryAll order submissions including cancelled and partial fills
Settlement is automatic at each contract's expiry time. Winning tokens credit your USDH balance at $1.00 per share. Losing tokens expire at $0. ## Limitations * Only Hyperliquid Outcome markets are available. Prediction markets on other protocols are not currently supported. * The AI signal panel covers a curated subset of active markets; not all Hyperliquid Outcome contracts are shown. * Slippage can be material on lower-volume contracts. Always review the Slippage field before confirming. * AI signals are based on price and market data only. Macro events, news, or off-chain developments are not factored in. ## Disclaimers * Prediction market positions resolve at binary outcomes. You either receive full payout at $1.00 per winning share or lose the full amount invested in losing shares. * All prediction market contracts are settled by Hyperliquid's Outcome protocol. Minara does not control settlement prices or outcomes. * Minara does not act as a counterparty or liquidity provider for prediction market trades. * AI signals displayed in the Prediction panel are for informational purposes only and do not constitute financial or investment advice. * Historical win rates and edge percentages are model estimates based on past price data. They are not indicative of future results. * All trading involves risk. Only trade with funds you can afford to lose. * You maintain full control of your positions at all times. Minara does not execute trades autonomously on your behalf. # Skills ## What is Minara Skills? Minara Skills is the official skill pack that gives any compatible AI agent access to crypto and stock trading, on-chain execution, and market intelligence. Once installed, your agent can analyze and trade crypto, US stocks, commodities, and forex; execute on-chain transactions across EVM, Solana, and Hyperliquid; manage wallets and credit-card on-ramp; and pull real-time market intelligence — all by talking to it in natural language. Minara Skills runs on top of the [Minara CLI](https://www.npmjs.com/package/minara) and ships as a drop-in package for [Claude Code](https://claude.com/claude-code), [OpenClaw](https://docs.openclaw.ai/tools/skills), and [Hermes](https://hermes-agent.nousresearch.com/). **What you can do with Minara Skills:** * Buy, sell, swap, convert, and transfer spot assets by ticker, token name, or contract address across 19 networks * Open and close perpetual futures positions on Hyperliquid with leverage, multi-wallet management, and AI autopilot * Place, list, and cancel spot and perps limit orders * Deposit, withdraw, and transfer between spot and perps wallets, including credit-card on-ramp through MoonPay * Pull on-chain data, token fundamentals, whale flows, trending tokens and stocks, equity research, commodities, and forex * Pay [x402](https://www.x402.org/)-enabled HTTP APIs directly from the Minara wallet * Manage your Minara subscription, credits, and premium plan *** ## Who is Minara Skills for? | User Type | Experience Level | How to Use | | ------------------------ | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | **Retail traders** | Any | Talk to your agent in plain English: *"Buy 100 USDC of ETH"*, *"Long ETH perp 5x"*, *"What's trending today?"* | | **Power users & quants** | Comfortable with CLIs | Drive the underlying [Minara CLI](https://www.npmjs.com/package/minara) directly for scripting, batch jobs, and reproducible workflows | | **Agent developers** | Building on Claude Code, OpenClaw, or Hermes | Drop the skill pack into your agent's skills directory and call Minara as a first-class tool — no glue code | *** ## How to access Minara Skills is distributed through GitHub: [github.com/Minara-AI/skills](https://github.com/Minara-AI/skills). Install it into one of three supported agent runtimes (Claude Code, OpenClaw, or Hermes) using the one-click installer for that runtime, then run `Login to Minara` from inside the agent to authenticate. You will need: * A working install of Claude Code, OpenClaw, or Hermes * Node.js (for `npm install -g minara`) * A Minara account ([minara.ai](https://minara.ai)) *** ## Installation Pick the installer that matches your agent. Each one-click script installs the Minara CLI from npm, copies the skill files into the agent's skills directory, and starts the login flow. ### Claude Code Send this prompt to your Claude Code agent: ``` Run "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/claudecode-minara-skill-setup.sh | bash" to install Minara CLI, Minara Skills and set following config. Follow the login URL when prompted. ``` This installs the Minara CLI globally, copies the skill into `~/.claude/skills/minara`, and opens the login URL in your browser. **Manual install:** ```bash npm install -g minara@latest git clone https://github.com/Minara-AI/skills.git /tmp/minara-skills cp -r /tmp/minara-skills/skills/minara ~/.claude/skills/minara ``` ### OpenClaw Send this prompt to your OpenClaw agent: ``` Run "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/openclaw-minara-skill-setup.sh | bash" to install Minara CLI, Minara Skills and set following config. Follow the login URL when prompted. ``` This installs the CLI, copies the skill into `~/.openclaw/skills/minara`, registers the skill in `openclaw.json`, and starts login. **ClawHub:** ```bash clawhub install lowesyang/minara ``` **Manual install:** clone the repo, copy `skills/minara` into your OpenClaw workspace, then add the skill to `~/.openclaw/openclaw.json`: ```json { "skills": { "entries": { "minara": { "enabled": true } } } } ``` ### Hermes Send this prompt to your Hermes agent: ``` Run "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/hermes-minara-skill-setup.sh | bash" to install Minara CLI, Minara Skills and set following config. Follow the login URL when prompted. ``` This installs the Minara CLI, copies the skill into `~/.hermes/skills/minara`, and starts the login flow. All setup scripts are idempotent. They support a three-tier skill download fallback: ClawHub → GitHub → clawhub CLI. *** ## First-run workflow The fastest way to validate that the install worked end-to-end. Three commands take you from a fresh install to your first trade. {% stepper %} {% step %} **Log in** Tell the agent: *"Login to Minara"*. The agent runs the CLI login command and opens a browser tab. Authenticate with your Minara account; the CLI stores the session locally. {% endstep %} {% step %} **Fund your wallet** Tell the agent: *"Show my Minara deposit address"* to deposit existing crypto, or *"Buy crypto with credit card"* to on-ramp via MoonPay. To trade perps, follow up with *"Deposit 500 USDC to perps"* to move funds from spot to the Hyperliquid perps wallet. {% endstep %} {% step %} **Trade** Tell the agent what you want: *"Buy 100 USDC worth of ETH"*, *"Swap 0.1 ETH to USDC"*, or *"Long ETH perp, 5x leverage"*. The agent confirms the trade details before executing. Review the **risk disclosure** carefully before approving. {% endstep %} {% endstepper %} *** ## Spot trading Spot trading covers buying, selling, swapping, converting, and transferring tokens across all [supported networks](#supported-networks). You can reference assets by ticker (`ETH`, `SOL`), name (`ethereum`), or contract address. **Examples:** * *"Buy 100 USDC worth of ETH"* * *"Sell all my SOL"* * *"Swap 0.1 ETH to USDC on Base"* * *"Transfer 50 USDC to 0xabc..."* The agent picks the right network and routing based on your wallet balances and the asset. *** ## Perpetual futures Perpetual futures are routed through Hyperliquid. You can open and close positions, set leverage, manage multiple wallets, and view trade history. **Examples:** * *"Long ETH perp"* * *"Short BTC, 10x leverage"* * *"Close my ETH position"* * *"Show my perps history"* ### AI Autopilot Autopilot lets the agent manage perps positions for you according to a strategy. Enable it with *"Enable AI autopilot for perps"*. Autopilot only acts within the scope you authorize, and you can disable it at any time. > **Risk:** Perpetual futures are leveraged products. Losses can exceed your initial margin. Review the risk disclosure before enabling autopilot or opening leveraged positions. *** ## Limit orders Limit orders work on both spot and perps. Place an order, list open orders, and cancel by ID. **Examples:** * *"Buy ETH when price hits $3000"* * *"Buy SOL at $150"* * *"List my limit orders"* * *"Cancel limit order \[id]"* *** ## Wallet and funds | Action | Example prompts | | ------------------------- | ---------------------------------------------------------------- | | **Check balance** | *"What's my balance?"* / *"Show my crypto portfolio"* | | **Deposit** | *"Show my deposit address"* / *"Buy crypto with credit card"* | | **Spot ↔ Perps transfer** | *"Deposit 500 USDC to perps"* / *"Withdraw 200 USDC from perps"* | | **Withdraw on-chain** | *"Withdraw 10 SOL to \[address]"* | | **Pay** | *"Pay 100 USDC to \[address]"* | Credit-card on-ramp uses MoonPay. Withdrawals to external addresses go on-chain and incur the standard network fee. *** ## Market intelligence Minara Skills exposes Minara's full market intelligence stack to your agent: real-time on-chain data, token fundamentals, whale flows, trending tokens and stocks, equity research, commodities, and forex. **Examples:** * *"What tokens are trending?"* * *"Search for SOL tokens"* * *"Show me whale flows on ETH"* * *"What's the outlook on NVDA?"* * *"Price of gold right now"* *** ## x402 payments Minara Skills can pay [x402](https://www.x402.org/)-enabled HTTP APIs directly from your Minara wallet. This lets your agent call paid APIs without you handling API keys or top-ups separately. The CLI handles the x402 handshake; you only see the agent ask for confirmation when a paid call is about to settle. *** ## Premium Manage your Minara subscription, credits balance, and plan from inside the agent. **Examples:** * *"Show my credits"* * *"Upgrade my Minara plan"* * *"What plan am I on?"* *** ## Supported networks Spot trading and on-chain operations are available on: Ethereum, Base, Arbitrum, Optimism, Polygon, Avalanche, Solana, BSC, Berachain, Blast, Manta, Mode, Sonic, Conflux, Merlin, Monad, Polymarket, XLayer. Perpetual futures are routed through Hyperliquid. *** ## Benchmark Minara Skills scored **88/100** on [crypto-skill-bench](https://github.com/Minara-AI/crypto-skill-benchmark) v3.0.2, evaluated on Claude Sonnet 4.6 across 76 scenarios. | Dimension | Score | | ---------- | ----- | | Safety | 91 | | Coverage | 86 | | Robustness | 88 | | Routing | 88 | | UX | 86 | 66 scenarios passed, 10 partial, 0 failed. Safety gate: PASS. The benchmark is open source. You can reproduce the run, inspect every scenario, and compare against other skill packs. *** ## What Minara Skills can and cannot do ### What you can define * The agent runtime (Claude Code, OpenClaw, or Hermes) * The networks and assets you want to trade * Whether to enable AI autopilot for perps, and within what scope * Limit-order prices, leverage levels, and margin allocations * Whether to fund via on-chain deposit or credit-card on-ramp ### What the platform controls * Order routing and venue selection * Network fees and on-chain confirmation times * Hyperliquid liquidity, funding rates, and liquidation logic for perps * MoonPay's KYC and pricing for credit-card on-ramp * Skill version updates (managed by `version-check.sh` per session) ### Current limitations * The skill is bound to the three supported runtimes; other agent frameworks are not yet integrated. * Direct deposits into the perps wallet are not supported. Funds must arrive via spot first, then transfer. * Hyperliquid charges a 1 USDT fee on perps withdrawals; the skill does not waive this. * Perpetual futures are only available on Hyperliquid. Other perps venues are not currently routed. * Some advanced order types (TWAP, iceberg) are not exposed through natural-language prompts. *** ## Tips for better results 1. **Be specific about amounts and assets.** *"Buy 100 USDC of ETH"* is unambiguous; *"buy some ETH"* will trigger a clarification round. 2. **Name the network when in doubt.** *"Swap 0.1 ETH to USDC on Base"* avoids the agent having to infer routing. 3. **Confirm before approving.** The agent always shows the trade details before executing. Read them; reject if anything looks wrong. 4. **Start small.** Validate the install with a $5 swap before moving real size. 5. **Use limit orders for entries you care about.** Market orders are faster but less precise on thin pairs. 6. **Keep the CLI updated.** Run `minara --version` and compare to npm; the session-level `version-check.sh` script flags upgrades automatically. 7. **Authorize autopilot in a scope you understand.** Start with a single asset and a small margin allocation before scaling. *** ## Disclaimers * All trading involves risk. Only trade with funds you can afford to lose. * Perpetual futures are leveraged products. Losses can exceed your initial margin. * Minara Skills is a tool that lets your agent operate the Minara platform. It is not financial advice. * Minara does **not** provide liquidity or act as a counterparty. Spot routes go through external venues; perps execute on Hyperliquid. * You retain full control. You can disable autopilot, cancel limit orders, or withdraw funds at any time. * Historical benchmark performance does not guarantee future results. *** ## Links * Repository: [github.com/Minara-AI/skills](https://github.com/Minara-AI/skills) * CLI on npm: [npmjs.com/package/minara](https://www.npmjs.com/package/minara) * Benchmark: [github.com/Minara-AI/crypto-skill-benchmark](https://github.com/Minara-AI/crypto-skill-benchmark) * License: MIT # Benchmark Benchmark shows the live performance of MINARA's own trading strategies. It is not a feature you configure. It is a transparency dashboard that lets you track how the strategies built and operated by Minara itself are performing in real markets. Access it at `/app/trade` → **Benchmark** tab. ## What you're looking at MINARA runs two active strategies: | Strategy | Asset | | --------- | ------ | | MINARA V2 | BTC | | MINARA V1 | SILVER | Each strategy has been deployed to live markets and trades using the same Autopilot execution infrastructure available to users. MINARA V2 trades Bitcoin (BTC) perpetuals on Hyperliquid using a trend-following approach. MINARA V1 trades silver (SILVER) perpetuals. Both strategies trade under real market conditions with real capital. ## Reading the dashboard **Total account value**: the current equity of the MINARA strategy portfolio, shown in USD and as a percentage change. **Chart view**: toggle between `$` (absolute P\&L) and `%` (percentage return). Filter by `72h` for recent performance or `All` for the full history. **Completed trades**: the full trade log, with every position opened and closed, entry price, exit price, and P\&L for each trade. **AI reasoning**: for each trade, the rationale Minara's AI used to enter or exit the position. This is the same reasoning layer that drives Autopilot for user accounts. **Positions**: current open positions held by the strategy. **Readme**: a description of the strategy logic for each version (V1, V2). ## Why it exists Benchmark serves as proof of work. Before asking users to run Autopilot on their own capital, Minara runs the same strategies with real funds. The results, including losses and drawdowns, are shown unfiltered. {% hint style="info" %} MINARA's performance on Benchmark does not predict your Autopilot results. Your strategies, risk settings, leverage, and allocated capital will differ. {% endhint %} # API The Minara Agent API gives developers, traders, and market analysts direct access to Minara's financial intelligence and trading execution through a standard HTTP interface.
### Key features **Real-time market data.** Query live data across crypto and stocks: wallet activity, DeFi metrics, on-chain flows, and alpha signals — all structured for agent consumption. **Trade suggestions.** Send a market context query and get back a direct long/short recommendation with a preset order payload you can execute immediately. Reduces the loop from signal to trade. **Text-to-swap.** Describe a trade in plain English; the API returns an executable on-chain transaction payload compatible with OKX DEX by default. **Prediction market.** Query AI-estimated probability distributions for event outcomes, backed by market data, news context, and uncertainty bands. Use it to identify mispriced odds and size positions with clearer risk boundaries. ### How it works Two billing methods: 1. **API Key** — Available with a **Pro or Partner** plan. Generate keys directly from your Minara profile. 2. **Pay-As-You-Go** — A flexible, permissionless option via the [x402 protocol](https://www.x402.org/), allowing usage-based payments with stablecoins like $USDC. \ **Ready to build?** Follow our guides to [Broken mention](broken://pages/PWjrBKiSd4zKX9Kk3gNs). # Authentication Minara provides two methods for authenticating API requests. ### API Key (Subscription) The standard method for **Pro** and **Partner** plan users. Include your API key in the `Authorization` header of every request. **Format:** ``` Authorization: Bearer ``` **Example:** ```bash curl -H "Authorization: Bearer sk-minara-xxxxxxxx" https://api-developer.minara.ai/v1/developer/chat ``` > **Security:** Treat your API keys like passwords. Never expose them in client-side code or public repositories. 👉 **Learn more:** [Broken mention](broken://pages/PWjrBKiSd4zKX9Kk3gNs) ### Pay-As-You-Go (x402) For usage-based access without a subscription, we support the [**x402 protocol**](https://www.x402.org/). Pay for API calls directly using stablecoins like $USDC (no subscription required). **x402 API URL**:[https://x402.minara.ai](https://x402.minara.ai/) **Explore our x402 endpoints:** [Minara on x402scan](https://www.x402scan.com/server/66307a3c-aeb9-4508-9531-71eed69bc9b5) 👉 **Learn more:** [Broken mention](broken://pages/N30vuC6vXVYQnNTfAfq1) # API Key The API Key method is available to **Pro** and **Partner** plan users. Generate keys from your Minara profile and include them in the `Authorization` header of every request. *** ## Requirements The Minara Agent API is available exclusively to Pro and Partner plan subscribers. If you are on a free plan, navigate to the **API** tab in your profile to see the upgrade prompt. If you downgrade your subscription, all active API keys are automatically paused and resume when you renew. *** ## Creating an API key 1. Go to your **Account Profile** at [minara.ai](https://minara.ai). 2. Select the **API Key** tab from the left menu and click **Create**.
API Key tab in Minara account profile showing Create button
3. Enter a name and description to identify the key's usage.
Create API key dialog with name and description fields
4. Once created, your API key is displayed. Copy and store it securely — it will not be shown again.
Newly created API key displayed for copying
*** ## Managing API keys | Action | Details | | -------------- | -------------------------------------------------------------------------------------- | | **View keys** | Keys are listed with only the last 4 characters visible. Click to reveal the full key. | | **Key limit** | Up to 5 API keys per Pro/Partner account. | | **Delete key** | Requires 2FA confirmation. Deletion is permanent. | *** ## Authentication Include your API key in the `Authorization` header of every request: ``` Authorization: Bearer ``` **Example:** ```bash curl -H "Authorization: Bearer sk-minara-xxxxxxxx" \ https://api-developer.minara.ai/v1/developer/chat ``` {% hint style="warning" %} Treat your API keys like passwords. Never expose them in client-side code or public repositories. {% endhint %} *** ## Billing All API calls consume **credits** from your Minara account. If credits run out, API requests pause until replenished. *** ## API reference Base URL: `https://api-developer.minara.ai` ### Chat **`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"}}}}}} ``` | Parameter | Type | Required | Description | | ----------------- | ------- | -------- | ---------------------------------------------------------- | | `mode` | string | Yes | `fast` for quick responses, `expert` for in-depth analysis | | `stream` | boolean | Yes | `true` for SSE streaming, `false` for standard JSON | | `message.role` | string | Yes | Must be `user` | | `message.content` | string | Yes | The query content | **Example:** ```bash curl -X POST https://api-developer.minara.ai/v1/developer/chat \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "mode": "fast", "stream": false, "message": { "role": "user", "content": "Analyze the recent price action of SOL." } }' ``` *** ### Intent to swap transaction **`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"}}}}}} ``` Convert natural language trading intent into an executable swap transaction payload, compatible with OKX DEX by default. | 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 | No | Chain name (e.g., "base", "ethereum", "arbitrum") | **Example:** ```bash curl -X POST https://api-developer.minara.ai/v1/developer/intent-to-swap-tx \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "intent": "swap 0.1 ETH to USDC", "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1", "chain": "base" }' ``` *** ### Perpetual trading suggestion **`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"}}}}}} ``` Get AI-powered perpetual trading suggestions with long/short recommendations, entry, stop loss, take profit, and confidence score. | Parameter | Type | Required | Description | | ----------- | ------ | -------- | --------------------------------------------- | | `symbol` | string | Yes | Trading symbol (e.g., "BTC", "ETH", "SOL") | | `style` | string | No | `scalping`, `day-trading`, or `swing-trading` | | `marginUSD` | number | No | Margin in USD | | `leverage` | number | No | Leverage multiplier (max: 40) | | `strategy` | string | No | Strategy type | **Example:** ```bash curl -X POST https://api-developer.minara.ai/v1/developer/perp-trading-suggestion \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "symbol": "BTC", "style": "day-trading", "marginUSD": 1000, "leverage": 10 }' ``` *** ### Prediction market analysis **`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"}}}}}} ``` AI-powered probability estimates for prediction market outcomes. | Parameter | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------- | | `link` | string | Yes | Prediction market event URL (e.g., Polymarket) | | `mode` | string | Yes | `fast` or `expert` | | `only_result` | boolean | No | Return probabilities only, without reasoning | | `customPrompt` | string | No | Custom instructions to guide the analysis | **Example:** ```bash curl -X POST https://api-developer.minara.ai/v1/developer/prediction-market-ask \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "link": "https://polymarket.com/event/example", "mode": "fast" }' ``` # x402 x402 is a pay-per-use API access method that requires no subscription. You pay for each call directly using stablecoins like USDC on Base, Solana, or Polygon. Minara x402 endpoint: `https://x402.minara.ai` Explore all endpoints: [Minara on x402scan](https://www.x402scan.com/server/66307a3c-aeb9-4508-9531-71eed69bc9b5) *** ## How x402 works x402 follows a payment-challenge flow: 1. You make a request to a protected endpoint without payment. 2. The server responds with `402 Payment Required` and payment instructions (amount, currency, recipient address, chain). 3. You include a payment proof in the `x-payment-response` header and retry the request. 4. The server verifies the proof, processes the payment on-chain, and returns the API response. The recommended approach is to use the x402 SDK, which handles this flow automatically. *** ## Getting started with the SDK ### Prerequisites * A crypto wallet with USDC (any EVM-compatible wallet, or a Solana wallet) * Node.js / Python / Go * Your wallet's private key (for signing payments) ### Install {% tabs %} {% tab title="Node.js" %} ```bash npm install @x402/fetch @x402/evm ``` {% endtab %} {% tab title="Python" %} ```bash pip install "x402[httpx]" ``` {% endtab %} {% tab title="Go" %} ```bash go get github.com/coinbase/x402/go ``` {% endtab %} {% endtabs %} ### Make a request The SDK handles payment challenges automatically. Just make requests normally. {% tabs %} {% tab title="Node.js" %} ```typescript 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 response = 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 response.json(); console.log(data.content); ``` {% endtab %} {% tab title="Python" %} ```python import asyncio, os from eth_account import Account from x402 import x402Client from x402.http.clients import x402HttpxClient from x402.mechanisms.evm import EthAccountSigner from x402.mechanisms.evm.exact.register import register_exact_evm_client async def call_minara(): client = x402Client() account = Account.from_key(os.getenv("EVM_PRIVATE_KEY")) register_exact_evm_client(client, EthAccountSigner(account)) async with x402HttpxClient(client) as http: response = await http.post( "https://x402.minara.ai/x402/chat", json={"userQuery": "What is BTC price?"} ) await response.aread() print(response.json()["content"]) asyncio.run(call_minara()) ``` {% endtab %} {% tab title="Go" %} ```go evmSigner, _ := evmsigners.NewClientSignerFromPrivateKey(os.Getenv("EVM_PRIVATE_KEY")) x402Client := x402.Newx402Client(). Register("eip155:*", evm.NewExactEvmScheme(evmSigner)) httpClient := x402http.WrapHTTPClientWithPayment( http.DefaultClient, x402http.Newx402HTTPClient(x402Client), ) req, _ := http.NewRequest("POST", "https://x402.minara.ai/x402/chat", strings.NewReader(`{"userQuery":"What is BTC price?"}`)) req.Header.Set("Content-Type", "application/json") resp, _ := httpClient.Do(req) // payment handled automatically ``` {% endtab %} {% endtabs %} For the full x402 quickstart, see [x402 documentation](https://docs.x402.org/getting-started/quickstart-for-buyers). *** ## API reference Base URL: `https://x402.minara.ai` All endpoints require the `x-payment-response` header (handled automatically by the SDK). ## Chat (Base Chain) > Ask Minara AI - Intelligent crypto assistant ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"ChatRequest":{"type":"object","required":["userQuery"],"properties":{"userQuery":{"type":"string","description":"Required. User query content."}}},"ChatResponse":{"type":"object","properties":{"content":{"type":"string","description":"AI response content."}}},"BadRequestError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"UnauthorizedError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/chat":{"post":{"summary":"Chat (Base Chain)","description":"Ask Minara AI - Intelligent crypto assistant","operationId":"x402Chat","tags":["AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Bad Request - Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized - Invalid payment response token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Chat Expert (Base Chain) > Ask Minara AI - Intelligent crypto assistant ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"ChatRequest":{"type":"object","required":["userQuery"],"properties":{"userQuery":{"type":"string","description":"Required. User query content."}}},"ChatResponse":{"type":"object","properties":{"content":{"type":"string","description":"AI response content."}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/chat/expert":{"post":{"summary":"Chat Expert (Base Chain)","description":"Ask Minara AI - Intelligent crypto assistant","operationId":"x402ChatExpert","tags":["AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Bad Request - Invalid parameters"},"401":{"description":"Unauthorized - Invalid payment response token"},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Perpetual Trading Suggestion > Get AI-powered perpetual trading suggestions with long/short recommendations, entry price, stop loss, take profit levels, and confidence score. ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"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."}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/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.","operationId":"x402PerpTradingSuggestion","tags":["Trading"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpTradingRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpTradingResponse"}}}},"400":{"description":"Bad Request - Invalid parameters"},"401":{"description":"Unauthorized - Invalid payment response token"},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## 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 x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"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":{"transaction":{"type":"object","description":"Swap transaction details","properties":{"chain":{"type":"string","description":"Chain name."},"inputTokenAddress":{"type":"string","description":"Input token contract address."},"inputTokenSymbol":{"type":"string","description":"Input token symbol."},"outputTokenAddress":{"type":"string","description":"Output token contract address."},"outputTokenSymbol":{"type":"string","description":"Output token symbol."},"amount":{"type":"string","description":"Transaction amount."},"amountPercentage":{"type":"number","description":"Amount percentage."},"slippagePercent":{"type":"string","description":"Slippage percentage."}}}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/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":"x402IntentToSwap","tags":["Trading"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentToSwapRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapTransactionResponse"}}}},"400":{"description":"Bad Request - Invalid parameters"},"401":{"description":"Unauthorized - Invalid payment response token"},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Prediction Market Analysis (Base Chain) > 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 x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"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)."}}},"BadRequestError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"UnauthorizedError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/prediction-market-ask":{"post":{"summary":"Prediction Market Analysis (Base Chain)","description":"AI-powered prediction market analysis. Analyze prediction market events and get probability estimates for each outcome with detailed reasoning.","operationId":"x402PredictionMarketAsk","tags":["Prediction"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionMarketRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionMarketResponse"}}}},"400":{"description":"Bad Request - Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized - Invalid payment response token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ### Multi-chain endpoints Solana and Polygon variants are available at `/x402/solana/chat`, `/x402/solana/chat/expert`, `/x402/polygon/chat`, and `/x402/polygon/chat/expert` with identical request/response shapes. *** ## Error handling | Code | Error | Meaning | | ----- | --------------------- | ------------------------------------------------------- | | `402` | `payment_required` | Normal — SDK handles this automatically | | `401` | `unauthorized` | Payment proof invalid or expired | | `400` | `bad_request` | Missing or invalid request parameters | | `429` | `rate_limit_exceeded` | AI endpoints: 60 req/min; Trading endpoints: 30 req/min | *** ## Resources * [x402 Protocol Documentation](https://docs.x402.org) * [x402 GitHub Repository](https://github.com/coinbase/x402) * [Minara on x402scan](https://www.x402scan.com/server/b9dea1bf-cf70-41d5-96b5-b91c924cfa50) # Assets Minara supports three categories of tradable assets: crypto perpetuals, tokenized stock perpetuals, and commodity perpetuals, all settled in USDC on Hyperliquid's on-chain order book. *** ## Crypto perpetuals Minara trades crypto perpetuals on Hyperliquid, a high-performance on-chain order book. Perpetuals are futures contracts with no expiry date. You hold them as long as you want, and the contract price tracks the underlying asset via a funding rate mechanism. **Supported assets**: all assets available on Hyperliquid are available in Minara, including Bitcoin (BTC), Ethereum (ETH), Solana (SOL), and many others. Popular pairs include BTC/USDC, ETH/USDC, and SOL/USDC. You can also trade hundreds of altcoin perpetuals from the same interface. The full list appears in the asset selector at `/app/trade/perps`. **No expiry**: unlike traditional futures, perpetuals don't settle on a fixed date. You open a position and hold it indefinitely, or until you close it or get liquidated. **Funding rates**: to keep the perpetual price close to the spot price, a funding payment is exchanged between long and short holders periodically. When funding is positive, longs pay shorts; when negative, shorts pay longs. The current funding rate is shown in the trading interface. **Leverage**: Minara supports up to 25x leverage on crypto perpetuals. Leverage multiplies both gains and losses. See [Margin and leverage](/docs/reference/margin-and-leverage) for how margin requirements work. The trading panel is on the right side of the screen. Two order types are available: **Market** (executes immediately at the best available price) and **Trigger** (executes when the asset reaches a price you specify). Both Autopilot and Copilot use this same underlying interface. {% hint style="info" %} Minara routes orders through Hyperliquid's on-chain order book. Execution is non-custodial: your funds stay in your Hyperliquid account, not held by Minara. {% endhint %} *** ## Stocks Minara gives you access to tokenized stocks as perpetual contracts on Hyperliquid. You can trade Apple (AAPL), Tesla (TSLA), NVIDIA (NVDA), Amazon (AMZN), Microsoft (MSFT), and other major equities using the same USDC-based interface as crypto. These are perpetual contracts whose price tracks the underlying stock. They are not actual shares. You do not receive dividends, voting rights, or any equity ownership. You are taking a leveraged position on the price movement of the stock. Trading is available 24/7, including outside traditional market hours, though liquidity and spreads may vary when the underlying exchange is closed. The trading mechanics are identical to crypto perpetuals: positions are denominated in USDC, funding rates apply, leverage is available (at lower maximums than crypto perps), and orders can be placed as market or trigger orders. Filter by **Stocks** in the asset selector to see all available instruments. {% hint style="info" %} Because these are perpetuals tracking stock prices rather than direct ownership, your exposure ends when you close the position. There is no settlement or delivery. {% endhint %} *** ## Commodities Minara supports trading commodity perpetuals including gold (XAU), silver (SILVER), and crude oil via Hyperliquid's order book. * **Gold (XAU)**: trade gold perpetuals as XAUUSDC, priced in USDC, 24/7 without a brokerage account. * **Silver (SILVER)**: silver futures perpetual, priced in USDC. * **Crude oil**: available as a perpetual contract. More commodities may be added as Hyperliquid listings expand. Filter by **Commodities** in the asset selector to see the current list. Commodity perpetuals work the same way as crypto perpetuals: no expiry, funding rates, and leverage available. Commodities are available 24/7, though liquidity varies by session. {% hint style="info" %} Commodity perpetuals track the underlying commodity price via oracle feeds. You are not taking delivery of physical goods. {% endhint %} *** ## Fees Trading fees apply to all perpetual trades and vary by asset class. See [Trading fees](/docs/trade/trading-fees) for the current rate schedule. # Trading fees Every trade on Minara executes on Hyperliquid's order book. Your total fee is the sum of two components: a **Hyperliquid fee** charged by the underlying exchange, and a **Minara fee** charged by the platform. Fees vary by asset class and trading mode. A **maker** order adds liquidity to the order book — typically a limit order that does not immediately fill. A **taker** order removes liquidity — a market order or a limit order that matches an existing order on entry. ## Crypto ### Autopilot | | Hyperliquid fee | Minara fee | Total | | --------- | --------------- | ---------- | --------- | | **Maker** | 0.015% | 0.015% | **0.03%** | | **Taker** | 0.045% | 0.015% | **0.06%** | ### Copilot (manual trading) | | Hyperliquid fee | Minara fee | Total | | --------- | --------------- | ---------- | ---------- | | **Maker** | 0.015% | 0.04% | **0.065%** | | **Taker** | 0.045% | 0.03% | **0.075%** | ## Commodities and stocks Covers silver, crude oil, and other commodities, as well as stocks. ### Autopilot | | Hyperliquid fee | Minara fee | Total | | --------- | --------------- | ---------- | ---------- | | **Maker** | 0.003% | 0.015% | **0.018%** | | **Taker** | 0.009% | 0.015% | **0.024%** | ### Copilot (manual trading) | | Hyperliquid fee | Minara fee | Total | | --------- | --------------- | ---------- | ---------- | | **Maker** | 0.003% | 0.04% | **0.043%** | | **Taker** | 0.009% | 0.03% | **0.039%** | ## Prediction markets Covers binary outcome contracts traded on Hyperliquid's Outcome market, powered by Outcomexyz. ### Copilot (manual trading) | | Hyperliquid fee | Minara fee | Total | | --------- | --------------- | ---------- | ---------- | | **Maker** | 0.04% | 0.04% | **0.08%** | | **Taker** | 0.056% | 0.03% | **0.086%** | # Overview Workflow is a visual automation tool built into Minara. You describe what you want to automate (in plain language or by filling in a template) and Minara builds a node-based pipeline that runs on a schedule or in response to market events. Access it at `/app/workflow`. {% embed url="" %} ## What you can automate Workflows combine triggers, conditions, and actions into a visual pipeline. Common use cases: * Monitor a wallet address and copy its trades automatically * Alert you (email or Telegram) when Bitcoin (BTC), Ethereum (ETH), Solana (SOL), gold (XAU), or a stock like NVDA crosses a price threshold * Run a weekly AI market summary covering BTC dominance, ETH DeFi activity, and macro signals, then send it to your inbox * Track Polymarket odds and notify you when a position shifts ## Quick templates The fastest way to start is with a pre-built template. Select one on the Workflow page and fill in the parameters. | Template | What it does | | -------------------------- | -------------------------------------------------------------------------------------------- | | Copy Trade | Mirrors trades from a monitored wallet address. Configurable buy amount and sell conditions. | | Polymarket Address Monitor | Tracks a Polymarket wallet's activity with optional AI analysis of trade quality. | | Polymarket Odds Monitor | Notifies you when a prediction market outcome crosses a probability threshold you set. | ## Build from a description If a template doesn't fit your use case, describe what you want in the chat input on the Workflow page. Minara generates the workflow and shows it as a node diagram. You can adjust it through follow-up prompts before deploying. {% hint style="info" %} Workflows can only be edited through the chat where they were created, and only before deployment. To change a deployed workflow, create a new one. {% endhint %} ## Node types **Triggers**: start the workflow when a condition is met: * **Token price monitor**: fires when a token crosses a price level (e.g. "ETH breaks $4,000" or "BTC crosses $120,000") * **Wallet activity monitor**: fires when a tracked wallet buys or sells * **Polymarket odds monitor**: fires when a prediction market outcome probability moves past a threshold * **Polymarket wallet monitor**: fires when a Polymarket wallet places a bet * **Scheduled**: runs on a fixed schedule (e.g. daily at 8 AM, every Sunday at 6 PM) * **Delayed start**: runs once after a specified delay **Logic**: control flow: * **If condition**: branches the workflow based on a condition being true or false **Actions**: what the workflow does when triggered: * **Notify via email**: sends an alert to the email linked to your account * **Notify via Telegram**: sends a message via Telegram bot (requires your `chat_id`) * **Trade (market order)**: executes a buy or sell on Base, Ethereum, or Solana * **Trade (stop market)**: triggers a trade when a price condition is met * **Minara AI query**: sends a prompt to Minara and uses the response downstream (e.g. in an email) * **Code**: runs custom logic generated by Minara (HTML email templates, data transformations, etc.) ## Credits and fees The **Minara AI Query** node consumes credits each time it runs. All other nodes are free to execute. Trades initiated by workflows incur the same trading fees as manual trades. If your credit balance runs out, all active workflows pause automatically. Keep sufficient credits to avoid interruptions to automated trading workflows. For credit details, see [How credits work](broken://pages/FrIxIPxclx8xWkxONGA2). # Price alert bot Build a reliable alert that watches prices and pings you the moment conditions hit. With Minara's monitor system, you can set high-precision, real-time alerts for token prices without worrying about delays or missed triggers. When the set price condition is met, Minara can instantly notify you without consuming any credits. *** ### What to expect * High-precision, real-time monitoring for **token absolute prices**\ (e.g., "Alert me when SOL hits $150"). * Works for **on-chain tokens** and **tokenized stocks**.\ Non-tokenized stock prices and price change percentage alerts are **not yet supported** in real-time mode. * Alerts can be sent via telegram or email. * **No credit consumption**: the monitoring is done on our backend, not by repeated AI queries. *** ### Example prompts * *"Alert me when **ETH** drops to **$4,000**."* * *"Email me if **SOL** rises above **$180**."* * *"When **DOGE** hits **$0.28**, send me an alert."* * *"Notify me when **BTC** crosses $100,000."* * *"Alert me when **gold (XAU)** drops below $3,000."* * *"Send me a Telegram message when **NVDA** reaches $1,200."* * *"Alert me if **AAPL** falls below $200."* *** ### How it works 1. **You tell Minara the asset and target price**. 2. Minara registers your alert in the monitor system. 3. The monitor system continuously tracks the token price in real time. 4. Once the price crosses your target, the monitor will trigger the workflow to send you an alert immediately. *** ### Best practice * **Use absolute price triggers** (≥ / ≤). Real-time % change tracking is not yet available. * Keep your telegram account linked and [Minara notification bot](https://t.me/MinaraNotificationBot) enabled to ensure delivery. * Check spam folder first if you didn't receive the alert email. * For small‑cap meme tokens, copycats and same‑name lookalikes are common, especially during hype. To avoid mistakes, always specify and double‑check the chain and the token's contract address. > Mainstream assets like BTC, ETH, or SOL are already disambiguated by contract. *** ### Future developments Minara is planning to support: * Percentage-based alerts (e.g., ±5% in 1h) * Non-tokenized stock prices in real time * Browser Push notifications * Auto-recurring notification bots: monitors and alerts will run continuously You *can* still track these via workflows by scheduling periodic checks, but each check will be conducted by Minara AI and consume credits, which can become costly for high-frequency setups. \ We recommend reserving this approach for low-frequency use cases. For example: * **Weekly market health check**: review market cap trends and macro indicators every Friday. * **Monthly asset performance review**: pull 30-day price change data for your top 5 holdings on the first day of each month. * **Long-term target tracking**: every Friday, evaluate our market bias by reviewing all bull- and bear-market top indicators. To explore more about the use cases above, please check out [Scheduled analysis](/docs/workflow/how-to-run-analysis-on-a-schedule). # Automated trade execution By setting order triggers, Minara place trades automatically when your target triggers are hit. Minara can watch for specific price conditions and automatically place orders when they're met, perfect for buying the dip, taking profits, or setting stop-losses without constant manual monitoring. *** ### What you'll build A workflow that: * Monitors the **absolute price** of a token (≥ or ≤ a set value) * Executes **buy, sell, or both** when the condition is met, including **take-profit (TP)** and/or **stop-loss (SL)** strategies * Sends you a notification confirming the execution > Price monitoring is handled by our monitor system: real-time and reliable, but only for supported tokens on supported chains. *** ### Example prompts You can simply describe the order logic you want. Minara will translate it into a workflow that uses our dedicated monitor system for high-precision execution. 1. **Simple Buy/Sell Trigger** > "If ETH price falls to 4,000 USDT, buy $500 worth of ETH." > > "If BTC price reaches 130,000 USDT, sell 0.1 BTC." > > "If gold (XAU) drops to $2,900, buy $200 worth." 2. **Buy + TP/SL Strategy** > "Buy 200 USDT of SOL if price ≤ 175 USDT, then take profit at 200 USDT and stop loss at 160 USDT." > > "If NVDA hits $1,000, buy $300 worth with a 5% stop-loss and 15% take-profit." 3. **Laddered Buy** > "Buy $200 ETH at 4,000 USDT, $200 at 4,150 USDT, and $200 at 4,250 USDT." > > "Buy $100 of AAPL at $200, $100 at $195, and $100 at $190." 4. **Partial Exit** > "If DOGE price hits 0.25 USDT, sell half my position." *** ### Best practices * Use **limit orders with TP/SL** for better risk management. * Keep your telegram account linked and [Minara notification bot](https://t.me/MinaraNotificationBot) enabled to get real-time execution updates. * Check spam folder first if you didn't receive the execution result email that you should've received. * Avoid unnecessarily small TP/SL gaps. Sudden price wicks can trigger premature exits. * For small‑cap meme tokens, copycats and same‑name lookalikes are common, especially during hype. To avoid mistakes, always specify and double‑check the chain and the token's contract address. > Mainstream assets like BTC, ETH, or SOL are already disambiguated by contract. *** ### Future developments * Percentage-based triggers (e.g., +5% in 24h) * Futures, leverage, and advanced strategies for order triggers * Multi-condition orders (e.g., trigger only if price condition + volume spike) * Auto-adjusting stop-loss (trailing SL) * More trigger types (e.g. news trigger for sell-the-news strategy) # Scheduled analysis Minara makes you stay informed without any manual check. Whether it's weekly market health checks, monthly portfolio reviews, or periodic strategy evaluations, this workflow keeps you in the loop consistently. ### Best practice * Choose a reasonable frequency. Avoid unnecessarily high-frequency checks to save credits. * Clearly specify the **topics (e.g. assets**, **metrics**, and **indicators)** you want in the analysis. * Use consistent scheduling patterns (e.g., every Friday, 9 AM) for easier tracking. * Email is recommended for long analysis reports and telegram is more suitable for shorter messages. ### Example prompts 1. **Weekly market health check**: every Friday at 10:00 AM, analyze global crypto market cap trends, BTC/ETH dominance, and top DeFi protocol activity. 2. **Monthly asset performance review**: on the 1st of every month at 9:00 AM, pull the 30-day price change, trading volume, and on-chain activity for BTC, ETH, SOL, and my other top holdings. 3. **Long-term target tracking**: every Friday at 8:00 AM, evaluate the market using all bull- and bear-market top indicators and send a summary to my email. 4. **Ecosystem watch**: every Monday at 11:00 AM, review Solana's top 10 active projects by daily wallet interaction growth. 5. **Sector rotation signal**: every 2 weeks, compare performance of L1s, L2s, and DeFi tokens, and suggest a rebalance strategy. 6. **Stock & macro digest**: every Monday morning, summarize the prior week's performance for NVDA, AAPL, TSLA, AMZN, and MSFT alongside any major macro developments. 7. **Gold and commodities watch**: every Wednesday, pull gold (XAU) price, crude oil price, and any macro drivers affecting commodity markets. ### Future developments * Integration with more **data sources** for richer, multi-domain analysis. # Copy trading bot Automatically mirror trusted wallet buy and sell strategies with Minara workflows, no manual effort needed. ### What you’ll build * A workflow that monitors target wallets on-chain * Auto-executes the same buy/sell trades with your Minara wallet * Supports spot tokens on supported chains *** ### Step-by-step 1. **Pick wallets to follow** * Get the wallet address you want to copy (e.g., `0x1234...abcd`). * Make sure this is an active trader with real volume — copying inactive or “spam” wallets won’t help. * You may select mutiple wallets to monitor and mirror in one workflow. 2. **Create a workflow in Minara** * Prompt example: > “Watch this wallet DbrdV2...(a wallet address) on the Solana chain, and copy each buy/sell action with $50 per trade.” 3. **Set execution rules** * Use fixed trade amounts (e.g., $50 per order) for predictability and easier risk control. 4. **Choose notification method** * Receive trade execution notification via email or telegram. 5. **Deploy and monitor** * The bot will monitor the wallet’s on-chain activity. * When a supported trade is detected, Minara will mirror it following your rules. * You’ll receive a notification each time a trade is executed. *** ### Best Practices * **Vet before you follow**: Many wallets belong to insiders or short-term memecoin players — research before copying. * **Start small**: Test with small balances first to check execution accuracy. * **Asset whitelist/blacklist:** only copy certain tokens, or exclude risky memecoins. *** ### Current Limitations * Only spot token trades are supported. * Copying is limited to supported chains detected by the Monitor system. *** ### Future Developments * Proportional trade sizing (e.g., match 10% of their position size). * Risk Control (e.g. setting daily/weekly spend limits) * Smarter filters (e.g., copy only if trade > $10,000, or exclude tokens under $1M market cap) * Portfolio mirroring (not just individual trades) * Futures and leverage support # Order types Minara's trading panel supports two primary order types, with modifiers that change how they execute. The same order types are available for crypto, stocks, and commodities. ## Market order A market order executes immediately at the best available price on the order book. You get filled quickly, but the exact price depends on current liquidity. Use a market order when speed of execution matters more than price precision — for example, closing a position quickly during volatile conditions. ## Trigger order A trigger order waits until the asset reaches a price you specify, then executes. There are two sub-types: **Limit trigger**: when the trigger price is reached, the order is placed as a limit order at your specified price. You will be filled at that price or better, but the order may not fill at all if the market moves away. **Stop trigger**: when the asset crosses a threshold price, the order executes at market. Used for stop-losses — it guarantees an exit but not a specific price. ## Order modifiers **Reduce Only**: the order will only reduce an existing position, never increase it or open a new one. Useful when placing stop-loss or take-profit orders to ensure they don't accidentally flip your position. **Post Only**: the order will only be placed as a maker order (added to the order book). If it would execute immediately as a taker, it is cancelled instead. Use this to avoid taker fees. ## Take-profit and stop-loss (TP/SL) You can attach take-profit and stop-loss levels to an open position directly from the positions panel. These are stored as conditional trigger orders that activate when the price reaches your target. * **Take-profit**: closes the position (fully or partially) when price moves in your favor to the target level * **Stop-loss**: closes the position when price moves against you to the threshold level {% hint style="info" %} Autopilot and Strategy Studio manage TP/SL automatically. When trading manually via Copilot, Minara's signal cards suggest TP and SL levels — you set them yourself when placing the order. {% endhint %} # Margin & leverage Margin is the collateral you put up to open a leveraged position. Leverage lets you control a larger position than your account balance would otherwise allow, multiplying both potential gains and potential losses. ## Cross-margin Minara uses cross-margin by default. This means all available USDC in your Hyperliquid account backs your open positions collectively. If one position runs at a loss, the remaining account balance absorbs it before liquidation occurs. The advantage is that you don't need to allocate funds per position. The risk is that losses on one trade reduce the margin available to all other open positions. ## Leverage limits | Asset class | Maximum leverage | | ----------------------------------------- | ----------------------- | | Crypto perpetuals (BTC, ETH, SOL, etc.) | 25x | | Stocks (AAPL, TSLA, NVDA, AMZN, MSFT) | Lower (varies by asset) | | Commodities (Gold/XAU, Silver, Crude Oil) | Lower (varies by asset) | The leverage selector is in the trading panel. Choose a lower multiplier to reduce liquidation risk. ## Initial margin Initial margin is the USDC required to open a position: ``` Initial margin = (position size × entry price) / leverage ``` For example: opening a $10,000 BTC position at 10x leverage requires $1,000 in initial margin. ## Maintenance margin Maintenance margin is the minimum equity required to keep a position open. It is lower than initial margin. If your account equity falls below the maintenance margin level for a position, that position is subject to liquidation. The maintenance margin requirement and your current margin ratio are shown on each open position in the positions panel. ## What happens when margin runs out If your equity falls below the maintenance margin level, the system closes your position. See [Liquidations](/docs/reference/liquidations) for the full process, including how to avoid it and what auto-deleveraging means. {% hint style="info" %} The simplest way to avoid liquidation is to use lower leverage and set a stop-loss. Autopilot's AI Stop-loss feature exits positions before the liquidation price is reached. {% endhint %} # Liquidations Liquidation happens when your account equity falls below the maintenance margin required to hold a position. The system closes the position to prevent your balance from going negative. ## How liquidation works Each open position has a **liquidation price** — the asset price at which your margin is insufficient. This price is displayed on every open position in the positions panel. As the market moves against you, your margin ratio decreases. When it reaches the maintenance margin threshold, liquidation is triggered. The position is closed by Hyperliquid's liquidation engine, typically at or near the liquidation price. Any remaining margin after the close is returned to your account. If the position size is large relative to available liquidity, there may be slippage. ## Auto-deleveraging In extreme market conditions — sharp moves with insufficient liquidity to fill liquidation orders — Hyperliquid's auto-deleveraging (ADL) system may activate. ADL matches the liquidated position against profitable traders on the opposite side, closing their positions at the bankruptcy price. If your position is selected for ADL, you receive notification and your position is reduced or closed. ADL is rare and is a last-resort mechanism. It does not incur additional fees. ## How to avoid liquidation **Set a stop-loss**: place a stop trigger order below (for longs) or above (for shorts) your entry price. This exits the position before it reaches the liquidation price. See [Order types](/docs/reference/order-types) for how stop triggers work. **Use lower leverage**: higher leverage brings the liquidation price closer to your entry. At 2x leverage, the asset must drop 50% before liquidation. At 20x, it only needs to drop 5%. **Monitor your margin ratio**: the positions panel shows your current margin ratio per position. Watch it during volatile periods. **Use Autopilot's AI Stop-loss**: when running Autopilot, enable the AI Stop-loss feature. It adjusts the stop dynamically based on market conditions and exits positions before they approach the liquidation price. {% hint style="info" %} You cannot recover a liquidated position — once triggered, it's closed. The best approach is prevention: lower leverage and a stop-loss set at your maximum acceptable loss. {% endhint %} # Personalization Minara's personalization system adapts analysis and responses to your trading habits, portfolio context, and stated preferences. Rather than returning the same generic output to every user, Minara uses information you provide — and patterns it observes over time — to make responses more relevant to how you actually work. All personalization modules are enabled by default. You can disable any of them at any time. *** ## Trading summary ### Minara wallet context
Minara incorporates your Minara spot wallet holdings into its analysis. When you ask market questions, Minara can factor in: * The assets you currently hold * Your exposure concentration * Risk distribution across the portfolio * Unrealized positions This means analysis is relative to your current situation, not answered in isolation. The context of Minara perpetual wallets is not yet integrated. ### External portfolio
You can import wallet addresses outside Minara. Minara summarizes your trading activity across those wallets, including: * Typical holding duration * Preferred trading pairs * Observed strategy patterns * Historical performance tendencies This gives Minara a broader picture of how you trade, beyond what happens inside the platform. *** ## Custom prompt
Custom Prompt lets you write system-level instructions that apply to all your Minara interactions. Use it to specify: * Preferred analysis depth or style * Indicators or frameworks you want Minara to prioritize * Response format (concise summary vs. detailed breakdown) * Assets or markets to focus on * Tone and how you want Minara to address you These instructions persist across sessions and take precedence over default behavior. *** ## Tags
Tags represent structured dimensions of your trading profile. Each dimension has a set of possible labels. Examples: * **Risk profile:** Aggressive / Balanced / Conservative * **Decision-making style:** Data-Driven / Narrative-Driven / Community-Driven / Tech-Driven * **Trading frequency:** Passive Holder / Market Watcher Minara may automatically infer and update tags based on your conversations over time. You can also set any tag manually. Once a tag is manually set, Minara will not overwrite it automatically. If a tag does not apply to you, set it to N/A. Tags help Minara calibrate how it frames analysis, suggestions, and explanations. *** ## Memories {% columns %} {% column %}
{% endcolumn %} {% column %}
{% endcolumn %} {% endcolumns %} Memories are specific facts Minara stores about your preferences, strategies, and past interactions. Examples: * Preferred trading timeframe * Preferred analysis approach * Typical risk tolerance Memories allow Minara to maintain continuity across conversations — you do not need to re-explain your context each time. You can delete any memory you do not want Minara to retain. # Multimodal input You can upload images and files directly in the chat input alongside your prompt. Minara reads the content and incorporates it into its response. **Limits:** up to 5 files per upload, 10 MB per file. **Supported formats:** images (PNG, JPG, etc.), Excel/CSV, PDF. *** ## How to use it Click the attachment icon in the chat input, select your files, then type your question or instruction. Minara processes the files together with your text and responds in one message. For best results, enable **Quality mode** when working with large or complex files. *** ## What you can do with it **Chart analysis** Upload a candlestick chart screenshot — raw or with your own annotations (trend lines, arrows, support/resistance levels). Minara reads the price structure and evaluates the logic of any annotations you've added. **Tweet or news screenshot review** Upload a screenshot of a tweet or news article. For tweets, Minara assesses the account and content for credibility signals. For news articles, Minara extracts the source, claims, and context, and flags anything that may be missing or misrepresented. **Excel/CSV analysis** Upload trading records or a dataset. Minara reads the structure, identifies patterns, summarizes P\&L drivers, and suggests improvements based on the data. **PDF summary** Upload a whitepaper or report. Minara summarizes the key claims, evaluates technical feasibility, tokenomics (if applicable), team credibility, and highlights risks. *** ## Tips * Pair files with a specific question — the more precise your prompt, the more useful the response. * You can upload multiple related files at once and ask questions that span all of them. * Well-formatted spreadsheets and text-selectable PDFs produce better results than scanned images of documents. # DMind LLM Minara is powered by the [DMind](https://dmind.ai/) series of finance-native models, which handle data structuring, analysis, and summarization. DMind is paired with general-purpose models — including Claude and GPT — to cover the full range of tasks Minara handles: research, analysis, decision support, and on-chain execution. The DMind models are trained on domain-specific financial and crypto data. This allows Minara to work with specialized market concepts, on-chain data structures, and financial instruments without requiring generic models to reason across unfamiliar territory. # Wallet security Minara creates a **custodial** smart wallet for each user. Users can explore any supported blockchain without needing gas tokens (like $ETH or $SOL) or managing a crypto wallet directly. Unlike traditional centralized exchanges, **this custodial smart wallet is not stored in Minara's internal database, but is an on-chain smart contract wallet**. Minara can manage the funds in this wallet but cannot hide, delete or blacklist it. In the future, users will have the ability to customize how Minara utilizes their funds. Minara's wallet system involves two types of wallets: * **Funding Wallet**: An automatically generated smart contract wallet for each user, storing the funds they deposit. It makes fund flows transparent, auditable, and verifiable, which is different from CEXs. * **Controller Wallet**: A wallet controlled by Minara that can manage the Funding Wallet and its funds, conducting transactions, staking, and other on-chain operations. This wallet uses advanced cryptography technology such as key sharding, multi-signature, and TEE to ensure security while maximizing signature efficiency. ## Funding Wallet Funding wallet is based on [Universal Account](https://developers.particle.network/intro/universal-accounts) by Particle Network. It's a kind of smart contract wallet built on the [ERC-4337](https://www.alchemy.com/overviews/how-do-smart-contract-wallets-work) standard and compatible with existing EOA wallets. User deposits are stored in this smart contract wallet, with every transaction publicly recorded and verifiable on-chain. **This ensures funds cannot be misused in private and allows for full auditing.** ## Controller Wallet
Minara's Controller Wallet uses Privy, TEE (Trusted Execution Environment) and a multi-party authorization signing mechanism. Its core features include: * **Sharded Key Management & TEE Custody**: Keys are encrypted and stored in shards across different security boundaries. They are encapsulated and retrieved within the TEE, ensuring they always remain in a trusted environment. * **M-of-N Authorized Signatures**: Multi-party authorization enhances transaction security. Independent services like business, risk control, and strategy services contribute to signature verification, minimizing single points of failure. * **Service Signature Key Protection**: AWS KMS provides independent protection for key signatures. * **Account Policy Control**: Supports customizable permission policies based on account types and user dimensions, dictating transfer permissions, contract types, transaction limits, and more. ## Technical References * [Privy & TEE Custody + Sharded Key Management](https://docs.privy.io/security/overview) * [Intel SGX Developer Guide](https://www.intel.com/content/www/us/en/developer/topic-technology/software-security-guidance/overview.html) * [AWS KMS (Envelope Encryption, IAM Policy)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html) # Tool Stack Minara integrates the following external tools, including various data sources from the financial and crypto sectors, as well as Minara team's private data and knowledge base. ## Data sources Minara does not rely on web search for actionable insights, **because they're often unreliable and outdated.** Instead, Minara opted to integrate various industry data sources, covering the following categories: * **Finance Data**: transactions, stocks, crypto, DeFi, NFTs, liquidation, Web3 project/VC information, etc * **Audience Data**: entities, holders, smart money, social identities, P\&L, relationships, etc * **Sentiment Data**: news, X posts and trends, Greed/Fear index, macro signals, policy headlines, etc These data are sourced from **50+** leading industry data and sentiment providers, including:
Data SourceData UsageLatency
Minara's private databaseOn/off chain identity, wallet tags, industry experience and know-how, private metrics and trading strategies.Real-time
ArkhamAnalyzing transactions, capital inflow&outflow and identifying entities.Real-time
Blockchain RPC providersFull data access to multiple blockchains.Real-time
Listing/Delisting AnnouncementCapture the latest token listing and delisting events.1 - 3s
CoinMarketCap/CoinGeckoComprehensive token information, price data and advanced metrics.Real-time
CoinGlassAdvanced cryptocurrency and ETF data & signals.Real-time
DeFiLlamaComprehensive DeFi data.Real-time
GlassnodeAdvanced blockchain and market intelligence.Real-time
NFTGoComprehensive NFT data and market insights.Real-time
Token launchpads like Virtuals.io/Pump.Fun/Bonk.funThe latest token launch and trading data.Real-time
RootDataComprehensive and reliable information on Web3 projects, teams, funding, and news.1min
Social mediaSocial media and sentiment data.Real-time
Global newsCapture macro trends and detect sentiment. Applicable to most scenarios.5-10s
PolymarketEvent prediction and probabilityReal-time
GoplusToken and smart contract security, and risk analysis.Real-time
xStocksTokenized representations of real-world stocks and ETFs.Real-time
OpenAI/Grok WebsearchWeb page search and scraper.Real-time
FMPAccurate financial data for over 70,000+ publicly traded stocks.Real-time
## Blockchain interaction | Tool | Usage | | ---------------- | ------------------------------------------------------------------------------------------------------------------------ | | Wallet operation | Send transactions using the user's smart wallet: trade crypto assets, stake, interact with contracts, and create tokens. | | N8N workflow | Create any kinds of crypto workflow by prompting. | # Support guide How to get help with Minara: support channels, response times, and security. ## Before opening a ticket Search this help center first. Most common questions about deposits, withdrawals, trading, and subscriptions are already answered in the FAQ sections. If you're looking for how-to guides and feature documentation, visit the [Minara documentation](https://minara.ai/docs). If you've searched and can't find an answer, open a support ticket. ## How to get support **Discord (fastest)** Join the official Minara Discord: [discord.com/invite/minaraai](https://discord.com/invite/minaraai) Navigate to the **open-ticket** channel and use the button to create a ticket. Support takes place inside ticket channels only, not in public channels or direct messages. Anyone who contacts you directly claiming to be Minara support is a scammer. **In-app** Type your issue in the Minara chat. For straightforward questions, Minara can help directly. For account or funds-related issues, the chat will direct you to Discord. ## Response times Ticket responses typically take up to 24 hours. Expect longer wait times on weekends and during high-traffic periods. Include as much detail as possible when opening a ticket: account email, wallet address, transaction hashes, and screenshots. This avoids unnecessary back-and-forth. ## Security **Minara will never ask for your private key, seed phrase, or authenticator codes.** Anyone asking for these is a scammer. Before interacting with any Minara-branded page or link, verify the URL. The official Minara domains are: * App: [minara.ai](https://minara.ai) * Documentation: [minara.ai/docs](https://minara.ai/docs) * Discord: [discord.com/invite/minaraai](https://discord.com/invite/minaraai) * X: [x.com/minara](https://x.com/minara) Scammers use domains that look similar (e.g., minara-ai.com, minara.app). When in doubt, access Minara only through links from the official X account or Discord. If you believe your account has been compromised, go to [Security incidents](/docs/support/faq/wallet-and-security/security-incidents) for immediate steps. # Account & access issues [Login and account access](/docs/support/faq/account-and-access/login-and-access) [Broken mention](broken://pages/aIg1k6rgavMhZeOu6Emi) # Login and account access **I can't log in to Minara.** Minara uses Google OAuth. Make sure you're using the Google account that was used to create your Minara account. Clear browser cache or try incognito mode. If using a VPN, try disabling it — Minara is not available in Mainland China, North Korea, and certain restricted regions. If you still can't log in, join our [Discord](https://discord.com/invite/minaraai) and open a support ticket. **My session keeps getting logged out.** This can happen after a period of inactivity or on a new device. Log in again via the Google button. If you're losing a session immediately after logging in, clear cookies and try a different browser. **I forgot which Google account I used.** There is no way to look up your account by email without a support ticket. Contact us on Discord with any details you remember (username, wallet address, approximate signup date). **How do I reset my authenticator app?** If you've lost access to your authenticator app (e.g., lost phone), contact support on Discord with account verification details. We cannot bypass 2FA without identity verification. # Deposit & withdrawal issues [Card deposit issues](/docs/support/faq/deposit-and-withdrawal/card-deposits) [On-chain deposit issues](/docs/support/faq/deposit-and-withdrawal/on-chain-deposits) [Withdrawal issues](/docs/support/faq/deposit-and-withdrawal/withdrawals) # Card deposit issues Minara does not operate card payment services directly. We aggregate third-party OTC providers (MoonPay, Banxa Pay, Alchemy Pay, Kodo Finance). For card payment issues, contact the provider directly. **I paid with my card but haven't received crypto.** In most cases, if a transaction fails, funds are automatically refunded to your payment method. If you haven't received crypto or a refund after 24 hours, contact the OTC provider with your payment proof and order ID: * MoonPay: [support.moonpay.com](https://support.moonpay.com) * Banxa Pay: [support.banxa.com](https://support.banxa.com/en/support) * Alchemy Pay: [ramp.alchemypay.org](https://ramp.alchemypay.org/) * Kodo Finance: [global.kodo.finance](https://global.kodo.finance/) **I can't pass KYC.** KYC requirements vary by provider and region. Try a different bank card, select an alternative payment channel, or contact the OTC provider's support directly. Minara cannot intervene in the KYC process. **I received less crypto than expected.** This is usually due to platform fees, exchange rate slippage, or gas fees. If the shortfall is unusually large, contact the OTC provider with your transaction details and receipt. **My card payment failed.** Try a different card or payment channel. You can also skip card payment entirely and deposit on-chain directly to your Minara wallet address. # On-chain deposit issues **My on-chain deposit hasn't arrived.** Most deposits complete within 5–30 minutes. 1. Verify you used the correct deposit chain and address. 2. Check the transaction status on a blockchain explorer — confirm it shows as successful on-chain. 3. If the transaction is confirmed on-chain but your Minara balance hasn't updated after 30 minutes, join our [Discord](https://discord.com/invite/minaraai) and open a support ticket with your transaction hash. **I deposited to the wrong network.** Contact us on Discord. There is no guarantee that assets sent to the wrong network can be recovered. Include your transaction hash and the network you used. **I deposited tokens from an unsupported chain.** Contact our Discord for technical support. Assets sent from unsupported chains may not be recoverable. **I can't deposit SOL from Binance to Minara.** Minara wallets are AA+ custodial wallets. Binance's mobile withdrawal does not support certain wallet architectures (AA+, multi-signature). Solutions: * Use Binance Web (not mobile) to withdraw. * Deposit via BSC or another supported chain instead. # Withdrawal issues **My on-chain withdrawal was rejected.** Common reasons: * Insufficient balance — leave enough to cover gas fees. * Invalid withdrawal address format. * Network mismatch between selected token and destination address. If the issue persists after checking these, contact us on Discord. **My withdrawal hasn't arrived in my external wallet.** Most withdrawals complete within a few minutes. Check the transaction status on a blockchain explorer using your transaction hash. If the transaction is confirmed on-chain but hasn't appeared in your wallet, the issue is with the receiving wallet — contact that wallet's support. **I accidentally withdrew to the wrong address.** On-chain transactions are irreversible. Minara cannot reverse a completed withdrawal. If the address belongs to a known exchange, contact that exchange's support with your transaction hash. # Trading issues [Orders and execution](/docs/support/faq/trading/orders-and-execution) [Assets and chains](/docs/support/faq/trading/assets-and-chains) # Orders and execution **My order didn't execute.** Before execution, Minara checks account balance, gas fees, and slippage settings. If the order failed: * Check that your wallet has sufficient balance (including gas). * Review the slippage tolerance — low tolerance on volatile pairs can prevent fills. * Check the Activity log (Asset → Activity) for the error details. If the order shows as executed but you don't see it in your position, check the correct wallet and chain. **How does Minara handle failed trades?** Minara uses a multi-layer retry mechanism. If network congestion or price volatility occurs during execution, it adjusts gas fees and retries automatically. If the trade ultimately fails, you'll see a detailed error in the Activity log. **Can I manually stop or pause an automated strategy?** Yes. You can pause, modify parameters, or stop any strategy at any time — including active Autopilot strategies or limit orders. This is by design; Minara's philosophy is "AI automation + human control." **Where can I view my trade history?** Go to Asset → Activity to view all transactions and account activity. **My Autopilot stopped running unexpectedly.** Common causes: credits ran out (Minara Call nodes consume credits), wallet connector disconnected, or the strategy hit a configured stop condition. Check your credit balance and verify the wallet connector is still active. **What are the trading fees on Minara?** Minara charges a fee on each executed perpetual trade. For the current fee schedule, see the [trading fees page](https://minara.ai/docs/guide/managing-funds-and-trading/trading-fees) in the Minara documentation. Spot trading fees vary by asset and chain. # Autopilot and Sharpe Guard **Why did Autopilot use 50% of my capital in a single trade?** Autopilot strategies allocate capital based on the position size configured in your strategy settings. By default, Sharpe Guard may deploy a large portion of available capital when its signal confidence is high. To limit exposure per trade, adjust the **Max position size** parameter before activating the strategy. If a trade has already executed and the size is larger than expected, you can manually reduce the position from the Trade tab. **Why is the strategy only opening longs and refusing to short?** Sharpe Guard determines trade direction based on the current market regime. During a sustained uptrend, the strategy intentionally avoids shorts to prevent trading against momentum — a common source of avoidable drawdown. Once market conditions shift, the strategy resumes opening positions in both directions. This is by design, not a bug. **Is Sharpe Guard V2 bugged or is this behavior intentional?** Most behaviors users flag as bugs are intentional changes in how V2 manages risk compared to V1. V2 is more conservative: it holds positions longer, avoids counter-trend entries, and sizes positions more carefully in volatile conditions. If you're seeing something that doesn't match this — repeated errors, positions that won't close, or trades that seem random — contact support on [Discord](https://discord.com/invite/minaraai) with your account email and the timestamps of the unexpected behavior. **Why was everyone switched to V2 without notice?** Sharpe Guard V2 was rolled out automatically because it shows substantially better risk-adjusted performance compared to V1 in both backtesting and live conditions. The migration was designed to be seamless for active users. We recognize that more advance notice would have been helpful. We're improving how we communicate strategy updates. If you have feedback about the transition, share it in the [Discord](https://discord.com/invite/minaraai) feedback channel. **Why is the strategy entering at what looks like the top of a candle?** Sharpe Guard generates signals at candle close. The actual order executes at the open of the following candle, which can appear to be a worse price when viewed on a chart in hindsight. This is standard behavior for signal-on-close strategies and is not slippage or a bug. During volatile sessions, entry timing may look suboptimal after the fact — this is normal and not specific to V2. **How does Sharpe Guard V2 decide when to switch direction?** V2 monitors trend and momentum signals on a rolling basis. When conditions shift from bullish to bearish (or vice versa), the strategy exits the current position and opens in the opposite direction after signal confirmation. A single candle is not enough to trigger a switch — V2 requires sustained confirmation to avoid false reversals in choppy markets. The behavior is deterministic: the same market conditions will always produce the same signal. **Can I go back to Sharpe Guard V1?** V1 is no longer available as an active strategy. If you preferred V1's behavior — more frequent entries, shorter hold times, or a different risk profile — you can build a strategy with similar parameters in Strategy Studio, or describe your preferred approach to Minara Copilot for suggestions. **Is V2 still in testing? Is it production-ready?** Yes, V2 is production-ready. It completed internal backtesting and a paper-trading phase before the general rollout. As with any algorithmic strategy, historical performance does not guarantee future results. Monitor your open positions and adjust settings as your needs change. **Why does V2 seem to perform worse on weekends?** Crypto markets on weekends have lower liquidity and wider spreads, which affects execution quality across all strategies — not just V2. Lower volume can also cause signals to fire on less reliable price action. This is a known characteristic of algorithmic strategies rather than a V2-specific issue. # Assets and chains **What assets and chains does Minara support?** Supported chains: Solana, Ethereum, Base, BSC, Arbitrum, Optimism. Additional chains are planned. For perpetual trading on Hyperliquid, Minara supports crypto perpetuals, tokenized stocks, and commodities. **Does Minara support cross-chain trading?** Yes. You can use assets on one chain (e.g., USDC on Ethereum) to purchase tokens on another chain. Minara handles the cross-chain transfer automatically — no manual bridging required. **What trade types does Minara support?** Currently: * Spot trading (market and stop market orders) * Perpetual futures on Hyperliquid (via Copilot and Autopilot) * Custom strategy trading via Workflow (copy trading, split entry/exit, etc.) Planned: futures trading, automated arbitrage, DeFi integrations. # Prediction Market Copilot Prediction Market Copilot analyzes Hyperliquid HIP-4 binary contracts and recommends YES, NO, or WAIT based on the gap between AI-estimated probability and the market's implied probability. This guide walks through reading a signal, sizing a trade, and tracking open positions. ## 1. Open Prediction Market Copilot Log in to your Minara account at [minara.ai](https://minara.ai). From the main navigation, select **Copilot**, then choose **Prediction Markets** from the tab bar at the top. *\[待上传]* {% hint style="info" %} Prediction Market Copilot is available on all account tiers. Execution requires a connected Hyperliquid wallet with a USDC balance. {% endhint %} ## 2. Read the signal list The signal list shows all active HIP-4 contracts. Each row displays the target price, time to settlement, current direction (YES / NO / WAIT), edge percentage, and confidence level. The list defaults to sorting by edge size — highest-confidence signal at the top. Color indicators: * 🟢 Green row: Copilot recommends YES * 🔴 Red row: Copilot recommends NO * ⚪ Gray row: Copilot recommends WAIT *\[待上传]* ## 3. Open a signal card Tap any row in the signal list to open the full signal card for that contract. The signal card shows: * Direction badge (YES / NO / WAIT) with confidence level (HIGH / MEDIUM / LOW) * AI-estimated probability vs market-implied probability (the current YES price) * Edge percentage (the gap between the two probabilities) * Expected value per dollar risked * Three specific TA reasons behind the recommendation * One risk note naming the most likely way the call could fail *\[待上传]* {% hint style="info" %} The edge percentage represents how far the AI probability deviates from the market-implied probability. A +14% edge means the AI estimates the outcome is 14 percentage points more likely than the market currently prices. {% endhint %} ## 4. Understand the AI probability vs market price comparison The core of each signal card is the probability comparison: **AI probability** is what the model estimates based on multi-timeframe technical analysis (1m/5m/15m/1h/4h candles, RSI, MACD, Bollinger Bands, EMA, ATR, support and resistance levels). **Market price** (also shown as market-implied probability) is the current YES contract price. YES priced at 0.58 means the market collectively assigns a 58% chance that the condition will be met. When the AI probability is higher than the market price, Copilot recommends YES. When it is lower, Copilot recommends NO. When the gap produces negative expected value on both sides, Copilot recommends WAIT. ## 5. Place a trade From the signal card, tap the **Buy YES** or **Buy NO** button (the active button matches Copilot's recommendation). Select your trade size using the preset buttons ($10 / $50 / $100 / $500) or enter a custom amount. The win/loss dollar preview updates in real time as you adjust the size. Review the amount, then swipe to confirm. The order routes to Hyperliquid through your connected wallet. *\[待上传]* {% hint style="warning" %} Copilot signals are not financial advice. Expected value calculations are statistical estimates based on model probability. Individual trades can and will lose. Only trade amounts you are comfortable losing. {% endhint %} ## 6. Track open positions Open the **Positions** tab to see active prediction market contracts you hold. Each position shows: * Contract (target price + settlement time) * Your side (YES or NO) * Current YES/NO price * Unrealized P\&L * Time remaining to settlement Settlement is automatic. Winning contracts credit your account at $1 per token. Losing contracts expire at $0. ## What's next * [How Copilot calculates expected value](https://github.com/Minara-AI/help-center/blob/main/faq/core-concepts/expected-value.md) * [Hyperliquid wallet setup](https://github.com/Minara-AI/help-center/blob/main/faq/managing-funds/hyperliquid-wallet.md) * [Trading Copilot](https://github.com/Minara-AI/help-center/blob/main/faq/trading/trading-copilot.md) # Research & analysis [Data accuracy](/docs/support/faq/research-and-analysis/data-accuracy) [Credits and cost](/docs/support/faq/research-and-analysis/credits-and-cost) # Data accuracy **Minara analyzed the wrong token.** Verify the contract address and chain shown in the response. Click the "Cooking completed" reasoning panel to see which data sources were used. Ask again with the contract address and chain specified explicitly. If Minara consistently returns wrong data for a specific token, share the chat link and open a ticket in Discord for a credit refund. **Minara's answer has factual errors.** Ask Minara to re-fetch and analyze again. For investment-critical data, cross-check key values across at least two independent sources. Minara labels key data with specific sources — you can ask "Where is this data from?" for a breakdown. **Minara agreed with my wrong assumption.** Avoid framing questions as statements with an answer embedded (e.g., "I think BTC is bearish, right?"). Minara may agree rather than contradict. Instead, ask for multi-angle analysis: "Analyze BTC and show how each signal supports or contradicts a bullish or bearish view." **What data sources does Minara use?** Over 50 professional data providers including Arkham, CoinMarketCap, CoinGlass, DeFiLlama, Glassnode, NFTGo, Polymarket, Goplus, and xStocks. Coverage spans on-chain transactions, price data, DeFi, social sentiment, macro signals, and tokenized stocks. # Credits and cost **Why did this query use more credits than expected?** Credit usage scales with: LLM processing, data fan-out (how many sources are queried), Deep Research depth, and Data Visualization chart rendering. To keep costs predictable: * Turn off Deep Research and Data Visualization when not needed. * Avoid stacking multiple heavy modes in one query. * In Data Visualization mode, avoid selecting extra "preferred charts." For an unusually large charge, share the chat link on Discord — the team can audit and potentially credit your account. **Typical credit costs** | Action | Approximate cost | | ---------------------------- | ---------------- | | Regular chat message | \~20 credits | | Deep Research report | \~40 credits | | Minara Call node in Workflow | \~15 credits | These are estimates — actual cost depends on tokens processed. **What pauses when I run out of credits?** When subscription credits are fully consumed: * Chatting with Minara * Deep Research * Creating new workflows * Running workflows with Minara Call nodes Credits refresh at the start of each billing cycle. You can also purchase a top-up pack (requires an active paid subscription). # Subscription & credits [How is the plan priced?](/docs/support/faq/subscription-and-credits/pricing) [How credits work](/docs/support/faq/subscription-and-credits/how-credits-work) [What are Sparks?](/docs/support/faq/subscription-and-credits/sparks) [Referral rewards](/docs/support/faq/subscription-and-credits/referral-rewards) [Manage subscription](/docs/support/faq/subscription-and-credits/manage-subscription) # How is the plan priced? Minara uses a **usage-based pricing model** built around **Credits** ([How credits work](/docs/support/faq/subscription-and-credits/how-credits-work)), our unit for AI computation. \ Each plan includes a fixed number of Credits plus **Bonus Sparks** ([What are Sparks?](/docs/support/faq/subscription-and-credits/sparks)) as monthly rewards. *** #### 1. Pricing Overview * **Credits** are used when you run AI queries, research, or workflows. * **Bonus Sparks** are reward points for community perks and future exchanges. * Plans scale by Credit volume, workflow capacity, and feature priority. * You can upgrade, downgrade, or top-up Credits anytime. *** #### 2. Individual Plans
*** #### 3. Business Plans
*** #### 4. Management * Credits **reset monthly** and **renew automatically**. * You can top up or change plans anytime; unused Bonus Sparks remain available. * **Annual billing** options offer extra savings. # How credits work We use credits to measure your usage on Minara. Whenever you perform actions that involve AI processing or specific workflow execution, credits are deducted based on token consumption. ## How Credits Work? #### When Are Credits Deducted? Credits are deducted when a message or task is completed or manually stopped. Including: 1. Regular chats with Minara 2. Deep Research report generation 3. Workflow creation and execution (applicable to specific nodes) If a response or task is interrupted due to a system error, **no credits will be deducted**. #### Typical Usage Examples > **Note:** The values below are estimated averages for reference only. Actual credit usage varies per action and is calculated based on the number of tokens used. | **Action** | **Est. Average Cost Per Action** | | ----------------------- | -------------------------------- | | Messaging | \~20 Credits | | Deep Research | \~40 Credits | | Minara Node in Workflow | \~15 Credits | #### Workflow Execution Rules > **Note**: For now, credits are only deducted for Minara nodes. However, please note that all running workflows will be paused if credits run out. | **Node Type** | **Credit Usage** | | ------------- | --------------------------- | | Monitor | Currently free | | Trade | Free | | Notify | Currently free | | Minara Call | Based on actual tokens used | #### **Need More Credits?** Credits are refreshed monthly at the beginning of your plan cycle. You can upgrade your plan (which takes effect immediately) or purchase a top-up credit pack (available only with an active subscription) at any time to keep things running smoothly. Enjoy your time with Minara! # What are Sparks? **Sparks** are extra reward points you get by: * Trading on Minara * Subscribing to Minara * Participating in Minara community campaigns * [Referrals](https://minara.ai/docs/referral-and-rewards) (you get Sparks from your invitees' trades and first subscription

You can check your Sparks details in Setting - Account

\ They're different from **Credits.** Credits are used for running AI tasks, while Sparks are like special energy you can use for rewards and perks inside Minara. You can use Sparks to unlock: * Unique Discord badge & role * NFT whitelist opportunities * Official traffic boost for your high-quality posts * Free entry to Minara's offline events * Even exchange them for plan upgrades in the future Sparks are our way to thank you for being an active explorer in the Minara ecosystem. We'll keep adding new ways to use them soon! # Referral rewards Invite your friends to join Minara and earn rewards together. ### Step by Step Guide 1. **Get your invite link**\ You'll find them in the **Invites** section of your profile. 2. **Share with friends**\ Send your link or code to people who haven't joined Minara yet.\ When they register their account using your invite, it counts as a referral. 3. **Earn rewards**\ You receive **Credits and Sparks** automatically based on the action of your invitees. (See "Reward Details" below for more details.) 4. **Track your progress**\ See your total invites, paid conversions, and rewards at a glance in your **Profile** - **Invites**. {% columns %} {% column %}
{% endcolumn %} {% column %}
{% endcolumn %} {% endcolumns %} *** ### Reward Tiers Minara's referral program uses a tiered reward system, and your rewards as an inviter increase as you bring more users to Minara. Each tier is determined by the **total number of invitees** who have successfully signed up through your link. Inviter rewards vary by tier and are granted when an invitee purchases a **paid plan for the first time**.
TierInviter Reward
First 10 Invites

Signup Reward: 200 Credits for each signup

First Purchase Reward:

  • 300 Credits
  • 50% of the Sparks your invitee receives from their first paid plan
11 to 50 Invites

Signup Reward: None

First Purchase Reward:

  • 400 Credits
  • 60% of the Sparks your invitee receives from their first paid plan
Above 50 invites

Signup Reward: None

First Purchase Reward:

  • 500 Credits
  • 70% of the Sparks your invitee receives from their first paid plan
{% hint style="info" %} **Invitee rewards remain the same:** every invitee receives extra **200 Credits** upon signup. {% endhint %} The reward inviter receives is determined at the moment when a reward-triggering event occurs. This means: * If you have **11 signups** when one of your early invitees pays for their first time,\ → you receive **Tier 2 rewards (400 Credits + 60% Sparks)** for that payment. * If you have **51 signups** at that time,\ → you receive **Tier 3 rewards (500 Credits + 70% Sparks)**. > *Credits* can be used across Minara's features. Learn more about credits in [How credits work](/docs/support/faq/subscription-and-credits/how-credits-work)\ > \&#xNAN;*Sparks* are special bonuses for limited events. Check out [What are Sparks?](/docs/support/faq/subscription-and-credits/sparks) for more details *** ### 💬 FAQs **Q1. Do I keep my rewards even if my plan has expired?**\ Yes. Earned Credits and Sparks remain in your account. **Q2. How is the Sparks bonus split?**\ Your friend receives the full Sparks bonus based on their plan (as normal), and you receive 50 % of the amount they receive. **Q3. Do reward credits expire?** Reward credits do not expire. Credits are used in the following order whenever you spend them: 1. **Plan Credits** – your plan credits that refresh every month; 2. **Reward Credits** – credits you earn from referral rewards; 3. **Top-up Credits** – credits you purchase manually as add-ons. **Q4. My invitee has paid. Why didn't I receive more rewards?** Please note that rewards are only granted for the **invitee's first paid plan.** If you didn't receive rewards correctly, please submit a ticket in our Discord. **Q5. Do invitee rewards change based on the inviter's tier?** No. Invitee rewards always remain the same. **Q6. Does the order in which people sign up matter?** No. The rewards you receive as an inviter are determined by your tier at the time the reward event is triggered. **Q7. Why didn't I receive signup Credits when inviting people?** Please check your reward tier. Signup Credits for inviters are only granted in Tier 1 (the first 10 invitees). If you still believe your rewards are incorrect, please contact us through [Discord](https://discord.com/invite/minaraai). # Manage subscription Managing your subscription is simple. Click "Manage" in the top right corner to access the subscription management page, where you can view your current plan details, usage, and billing cycle ## 1. **manage Your subscription plans** Managing your subscription is simple. Click **"Manage"** in the top right corner to access the subscription management page, where you can view your current plan details, usage, and billing cycle. You can upgrade or downgrade your plan at any time. Upgrades will take effect immediately once payment is completed, and downgrades will take effect in the next billing cycle. *** ## 2. Subscription & Top-up Policy #### Subscription & Billing * Subscription fees are **charged upfront** and are **non-refundable** unless legally required or explicitly stated otherwise. * Subscriptions **automatically renew** at the end of each billing cycle unless downgraded to the free plan. *** #### Changing Plans **Upgrading** * Upgrading refers to switching from a lower-tier subscription plan to a higher-tier one. * The upgrade takes effect **immediately** after **payment is completed**. * **Your current billing cycle remains unchanged** — the renewal date stays the same as your original subscription. * You will only be charged the **price difference** between the new plan and your existing plan. * Your **credits will be added** based on the new plan's allocation, while keeping the same expiry date. **Example:** > You subscribed to the **Starter Plan ($49)** on **May 1**, and decided to upgrade to the **Partner Plan ($199)** on **May 10**.\ > You will be charged: $199 - $49 = $150 > > After the payment, your plan is upgraded to Partner immediately, and your subscription still renews on **June 1**. > > This amount of credits are added to your account: 41500-2600= 38900 *** **Downgrading** * Downgrading means switching from a higher-tier plan to a lower-tier one. * Downgrades take effect **at the start of the next billing cycle**. Your current plan will remain active until expiration. *** #### Cross-Plan Switching Rules | From \ To | Plan Tier | | ----------------- | ---------------------- | | Monthly → Monthly | ✅ Any plan | | Yearly → Yearly | ✅ Any plan | | Monthly → Yearly | ✅ Equivalent or higher | | Yearly → Monthly | ❌ Not yet supported | *** #### Top-up Credits Pack **Purchase Rules** * You can purchase a credit top-up only when you are on a **paid subscription plan** and have **consumed all your current credits**. **Usage Rules** 1. Top-up credits will only be used after your subscription credits are **fully consumed**. 2. Top-up credits are only available while an **active subscription** is in place. 3. Top-up credits do not replace subscription credits—they are supplementary. **Example Scenarios:** * On **June 28**, your subscription credits run out. You purchase a top-up. → Now you're using top-up credits. * On **June 29**, your subscription expires. → Now you switch to the **Free Plan**. **Top-up credits are unavailable.** * You use up the free credits (if you have any). → Top-up credits still cannot be used unless a paid subscription is reactivated. * On **July 1**, you subscribe again. → **Top-up credits are preserved** and remain active, but will only be used after the new plan's credits fully consumed. *** #### Service Suspension Once your subscription credits are fully consumed, the following features will be **temporarily paused**: * 💬 Chatting with Minara * 📊 Using DeepResearch * ⚙️ Creating new workflows * 🧠 Running workflows with Minara Call nodes #### Refund Policy * All subscription fees and top-up purchases are **non-refundable** after payment, unless: * Required by applicable consumer protection laws, or * Explicitly outlined in a special offer or promotion. * Refunds for plan upgrades follow the formula mentioned in section "Changing Plans". * No refunds are issued for: * Downgrades * Mid-cycle cancellations * Expired plans * Unused top-up credits # Wallet & security issues [Wallet and balance](/docs/support/faq/wallet-and-security/wallet-basics) [Export your private key](/docs/support/faq/wallet-and-security/export-private-key) [Security incidents](/docs/support/faq/wallet-and-security/security-incidents) # Wallet and balance **My wallet balance looks wrong.** Refresh the page and check you're viewing the correct wallet (EVM Spot Wallet vs. Solana Spot Wallet vs. Perps wallet). Each wallet holds different assets on different chains. If the balance is still incorrect after refreshing, check the transaction history (Asset → Activity) to confirm recent deposits or withdrawals. If a confirmed on-chain deposit isn't reflected, open a Discord ticket with your transaction hash. **Will Minara execute trades without my authorization?** No. Every trade requires your explicit confirmation. Large transactions trigger a secondary confirmation step. Automated strategies (Autopilot, Workflow) only execute after you have explicitly activated them. **What kind of wallet does Minara use?** Minara creates a custodial smart contract wallet for each user, built on the ERC-4337 standard (Universal Account by Particle Network). It is an on-chain wallet — not stored in Minara's internal database. Minara can manage funds in the wallet but cannot hide, delete, or blacklist it. Every transaction is publicly verifiable on-chain. **Why can't I deposit SOL from Binance to Minara?** Binance's mobile withdrawal does not support AA+ custodial wallets (the type Minara uses). Use Binance Web instead, or deposit via BSC or another supported chain. **I sent assets to the wrong chain. Can I get them back?** If you sent to a supported chain you didn't intend (for example, USDC on Ethereum instead of USDC on Base), contact support on [Discord](https://discord.com/invite/minaraai) immediately with your transaction hash. Recovery options depend on the specific situation, but assets sent to a supported chain can often be accessed. If you sent to an unsupported chain entirely, see below. **I deposited from an unsupported chain. Can I recover my funds?** Contact us on Discord immediately with your transaction hash. Recovery is not guaranteed — common reasons for unrecoverable deposits are unsupported blockchains or incorrect recipient addresses. **How do I export my private key?** See the [export private key guide](https://minara.ai/docs/guide/export-private-key) in the Minara documentation. # Security incidents **My account was hacked. What should I do?** Act immediately: 1. **Change the password** of the Google account linked to your Minara account. 2. **Log in to Minara** — check Asset → Activity for suspicious transactions. Pause any active automated strategies. Transfer remaining assets to a secure wallet. 3. **Preserve evidence** — take screenshots of suspicious transactions and note transaction hashes. You will need these for an investigation. 4. **Contact support** on [Discord](https://discord.com/invite/minaraai) with your account details and evidence. **I think I've been scammed.** Do not send additional funds. Contact Minara support on Discord immediately. Save all communications and transaction records. Minara cannot reverse completed on-chain transactions, but can help investigate and, where possible, escalate to relevant parties. **I received a message claiming to be from Minara support asking for my private key.** This is a scam. Minara will never ask for your private key, seed phrase, or authenticator codes. Report the message and contact the real Minara support on our official Discord: [discord.com/invite/minaraai](https://discord.com/invite/minaraai). # Export your private key Exporting your private key lets you import your Minara wallet into any compatible external wallet (MetaMask, Rabby, etc.) or recover it independently. {% hint style="warning" %} Your private key gives full control over your wallet. Never share it with anyone. Minara support will never ask for it. Each wallet allows a maximum of three successful exports in any 24-hour window. {% endhint %} ## 1. Open Settings Click your avatar in the top-right corner. In the left sidebar, select **Settings**. Under the **Wallet** section, click **Export private key**.
Settings panel showing the Export private key option under Wallet
## 2. Select a wallet Choose the wallet whose private key you want to export. Minara may hold multiple wallets — EVM Spot Wallet, Solana Spot Wallet, and any additional wallets you have created.
Select Wallet dialog with EVM Spot Wallet, Solana Spot Wallet, Wallet A, and bot listed
Click the wallet to select it, then click **Next**.
EVM Spot Wallet selected with radio button active
## 3. Enable Authenticator App (first time only) If you have not yet set up two-factor authentication on your account, Minara prompts you to do so before proceeding. You will see a QR code and a manual setup code. Open your authenticator app (Google Authenticator, Authy, or any TOTP-compatible app), scan the QR code, and click **Next**. {% hint style="info" %} This step only appears once. After your authenticator app is linked, future exports skip directly to the verification step. {% endhint %} ## 4. Enter your verification code Enter the 6-digit code currently shown in your authenticator app. The code refreshes every 30 seconds — if it expires, wait for the next one. ## 5. Copy your private key Your private key is shown but hidden by default. Make sure no one is looking at your screen, then click **Click to reveal**.
EVM Spot Wallet Private Key screen with hidden key and Click to reveal option
Click **Copy** to copy the key to your clipboard. Store it somewhere secure — a password manager or encrypted storage. Do not save it in plain text. Once you close this dialog, the key is no longer accessible through this screen. You can export again (up to three times per 24 hours) if needed. # Workflow issues [Workflow troubleshooting](/docs/support/faq/workflow-issues/common-issues) # Workflow troubleshooting **My workflow was deployed but didn't do anything.** Common causes: the trigger condition wasn't met, a required connector (Telegram, email, exchange) is missing or unauthorized, or the workflow uses a node type that isn't fully supported yet. What to check: * Confirm the workflow is based on a supported template (price alert, automated trade, scheduled analysis, copy trading). * Verify all connectors are correctly linked and authorized in your settings. * Review each node's logic to confirm inputs are valid. Open a Discord ticket with your workflow ID if the issue persists. **My price alert triggered once and then stopped.** This is expected. Price-triggered workflows are one-shot by design — each branch executes once when the condition is met, then ends. For continuous monitoring, set multiple price-triggered branches in one workflow, or use a scheduled workflow instead. **I set up an email alert but never received anything.** Common causes: * The workflow failed before reaching the email node (check workflow logs). * The email connector is not verified or authorized. * The email went to spam. * Credits ran out before the email node executed. Check your spam folder and verify your email connector settings. Open a Discord ticket with your workflow ID if needed. **My workflow stopped running after some time.** Most likely cause: credits ran out. All active workflows pause automatically when subscription credits are fully consumed. Check your credit balance and top up or upgrade your plan if needed. **Can I set multiple price targets in one workflow?** Yes. Add multiple price-triggered branches — each fires independently when its condition is met. For continuous monitoring of the same price level, use a scheduled workflow. **What workflow types are stable and supported?** Currently stable: * Price alert bot * Automated trade with TP/SL * Scheduled analysis report * Copy trading bot Custom workflows outside these templates may not be fully supported yet. # Technical issues [App issues](/docs/support/faq/technical-issues/app-issues) [How to get support](/docs/support/faq/technical-issues/get-support) # App issues **The app won't load.** * Check that you're not in a restricted region (Mainland China, North Korea, and certain other regions are not supported). * Confirm your internet connection is working. * Clear browser cache and cookies, try incognito mode, or switch browsers. * On mobile, try switching between Wi-Fi and mobile data. If the issue persists, contact us on [Discord](https://discord.com/invite/minaraai). **Chat appears frozen after I submit a question.** Some requests trigger long-running background jobs (multi-source data fetches, large on-chain scans, chart rendering). The UI may appear inactive for 1–2 minutes while results process. 1. Wait for the completion window to close. 2. If still stuck after 2 minutes, refresh the page and resume the chat. 3. If the chat is unresponsive after refreshing, share the chat link and open a Discord ticket. **Minara gave no output at all.** 1. Check your credit balance — queries don't run without credits. 2. Check subscription status. 3. Refresh the page or start a new chat, then retry. 4. Contact Discord if the issue persists. **My data isn't syncing between mobile and desktop.** Make sure you're logged into the same account on both devices. Refresh or re-login on both. The web version on Chrome (PC) is the primary supported interface — the native mobile app is still in development. # How to get support **Discord (fastest)** Join [discord.com/invite/minaraai](https://discord.com/invite/minaraai) and open a ticket in the support channel. Include your account email, a description of the issue, and any relevant transaction hashes or screenshots. **In-app** Type "I have a problem" in the Minara chat. Minara can handle basic troubleshooting and will direct you to Discord for more complex issues. **What to include in a support ticket** * Your account email or wallet address * A clear description of what happened * Steps to reproduce the issue * Any transaction hashes (if funds-related) * Screenshots or screen recordings The faster you provide this, the faster we can help.