API 参考（x402）

开发者 x402 API

Minara 的 x402 端点采用按需付费模式的技术规范。

基础 URL: https://x402.minara.ai

Chat (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid payment response token

application/json

402

Payment Required

application/json

post

/x402/chat

POST /x402/chat HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "userQuery": "What is the current price of BTC and what are the key support levels?"
}

{
  "content": "BTC is currently trading at $98,450. Key support levels are at $96,500 and $94,200..."
}

Chat Expert (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/chat/expert

POST /x402/chat/expert HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "userQuery": "Provide a comprehensive analysis of ETH including on-chain metrics and trading strategy"
}

{
  "content": "Comprehensive ETH analysis: [Detailed expert analysis content]..."
}

Chat (Polygon Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid payment response token

application/json

402

Payment Required

application/json

post

/x402/polygon/chat

POST /x402/polygon/chat HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "userQuery": "What is the current price of BTC and what are the key support levels?"
}

{
  "content": "BTC is currently trading at $98,450. Key support levels are at $96,500 and $94,200..."
}

Chat Expert (Polygon Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/polygon/chat/expert

POST /x402/polygon/chat/expert HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "userQuery": "Provide a comprehensive analysis of ETH including on-chain metrics and trading strategy"
}

{
  "content": "Comprehensive ETH analysis: [Detailed expert analysis content]..."
}

Chat (Solana Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/solana/chat

POST /x402/solana/chat HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "userQuery": "Show me the top trending tokens on Solana right now"
}

{
  "content": "Top trending Solana tokens: 1) WIF - up 24% with $45M volume..."
}

Chat Expert (Solana Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/solana/chat/expert

POST /x402/solana/chat/expert HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "userQuery": "Analyze the liquidity distribution and whale movements for JUP token"
}

{
  "content": "[Comprehensive expert analysis of JUP token with on-chain metrics]..."
}

Perpetual Trading Suggestion

post

Get AI-powered perpetual trading suggestions with long/short recommendations, entry price, stop loss, take profit levels, and confidence score.

授权

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

symbolstring必填

Required. Trading symbol (e.g., 'BTC', 'ETH', 'SOL').

stylestring · enum可选

Optional. Trading style: 'scalping', 'day-trading', or 'swing-trading'. Default: 'scalping'.

Default: scalping可能的值:

marginUSDnumber可选

Optional. Margin in USD. Default: 1000.

Default: 1000

leveragenumber · 最小值: 1 · 最大值: 40可选

Optional. Leverage multiplier (max: 40). Default: 10.

Default: 10

strategystring可选

Optional. Strategy type. Default: 'max-profit'. More strategies coming soon.

Default: max-profit

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/perp-trading-suggestion

POST /x402/perp-trading-suggestion HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "symbol": "BTC",
  "style": "day-trading",
  "marginUSD": 1000,
  "leverage": 10,
  "strategy": "max-profit"
}

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC broke above key resistance at $97,500 with strong volume",
    "RSI at 62 indicates bullish momentum without being overbought",
    "MACD showing bullish crossover"
  ],
  "risks": [
    "Potential pullback at $100,000 psychological resistance",
    "High volatility expected around upcoming Fed meeting"
  ]
}

Intent to Swap Transaction

post

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

授权

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

intentstring必填

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

walletAddressstring必填

Required. User wallet address (0x...).

chainstring可选

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

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/intent-to-swap-tx

POST /x402/intent-to-swap-tx HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 109

{
  "intent": "swap 0.1 ETH to USDC",
  "chain": "base",
  "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1"
}

{
  "transaction": {
    "chain": "base",
    "inputTokenAddress": "0x4200000000000000000000000000000000000006",
    "inputTokenSymbol": "ETH",
    "outputTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "outputTokenSymbol": "USDC",
    "amount": "0.1",
    "amountPercentage": 100,
    "slippagePercent": "0.5"
  }
}

Prediction Market Analysis (Base Chain)

post

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

授权

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

linkstring必填

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

modestring · enum必填

Required. Chat mode: 'fast' or 'expert'.

可能的值:

only_resultboolean可选

Optional. Only return prediction probabilities without reasoning. Default: false.

Default: false

customPromptstring可选

Optional. Custom instructions to guide the analysis. Use this to specify focus areas, risk preferences, or analysis style.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid payment response token

application/json

402

Payment Required

application/json

post

/x402/prediction-market-ask

POST /x402/prediction-market-ask HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 241

{
  "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31",
  "mode": "fast",
  "only_result": false,
  "customPrompt": "Focus on recent news and sentiment analysis. Be more conservative in probability estimates."
}

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "Based on recent polling data and historical trends, Trump maintains a slight lead in key swing states. However, the race remains highly competitive with significant uncertainty..."
}

端点

聊天（Base 链）

端点： POST /x402/chat

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

描述

userQuery

字符串

是

用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/chat \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "BTC 当前价格是多少，关键支撑位在哪里？"
  }'

响应

状态： 201 已创建

{
  "content": "BTC 当前交易价格为 $98,450。关键支撑位在 $96,500 和 $94,200。近期放量突破 $97,000 表明可能延续看涨趋势..."
}

聊天专家（Base 链）

端点： POST /x402/chat/expert

向 Minara AI 提问 - Base 链上的智能加密货币助手，专家模式

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

描述

userQuery

字符串

是

用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/chat/expert \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "请提供 ETH 的全面分析，包括链上指标和交易策略"
  }'

响应

状态： 201 已创建

{
  "content": "ETH 全面分析：\n\n**价格走势**：ETH 当前交易价格为 $3,420，正在 $3,400-$3,500 区间附近盘整...\n\n**链上指标**：活跃地址环比增长 12%，表明网络活动在增加...\n\n**交易策略**：可考虑在回调至 $3,300 支撑位时分批买入，目标位为 $3,600 和 $3,850..."
}

聊天（Solana 链）

端点： POST /x402/solana/chat

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

描述

userQuery

字符串

是

用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/solana/chat \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "显示我 Solana 当前最热门的代币"
  }'

响应

状态： 201 已创建

{
  "content": "Solana 当前最热门代币：\n1. WIF - 上涨 24%，24 小时成交量 $45M\n2. BONK - 上涨 18%，社区活跃度强\n3. JUP - 近期拉升后进入盘整，成交量达 $38M..."
}

聊天专家（Solana 链）

端点： POST /x402/solana/chat/expert

向 Minara AI 提问 - Solana 链上的智能加密货币助手，专家模式

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

描述

userQuery

字符串

是

用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/solana/chat/expert \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "分析 JUP 代币的流动性分布和巨鲸动向"
  }'

响应

状态： 201 已创建

{
  "content": "**JUP 代币深度分析**\n\n**流动性分布**：主要 DEX 上的总流动性为 $125M，其中 65% 集中在 $0.85-$0.92 区间...\n\n**巨鲸活动**：前 10 大持有者控制了 34% 的供应量。过去 24 小时内检测到 3 笔显著的巨鲸交易，买入总额达 $4.2M...\n\n**风险评估**：在 $1.00 关口上方存在中等流动性风险。仓位规模应考虑这一点..."
}

聊天（Polygon 链）

端点： POST /x402/polygon/chat

向 Minara AI 提问 - Polygon 链上的智能加密货币助手

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

描述

userQuery

字符串

是

用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/polygon/chat \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "BTC 当前价格是多少，关键支撑位在哪里？"
  }'

响应

状态： 201 已创建

{
  "content": "BTC 当前交易价格为 $98,450。关键支撑位在 $96,500 和 $94,200。近期放量突破 $97,000 表明可能延续看涨趋势..."
}

聊天专家（Polygon 链）

端点： POST /x402/polygon/chat/expert

向 Minara AI 提问 - Polygon 链上的智能加密货币助手，专家模式

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

描述

userQuery

字符串

是

用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/polygon/chat/expert \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "请提供 ETH 的全面分析，包括链上指标和交易策略"
  }'

响应

状态： 201 已创建

{
  "content": "**ETH 全面分析**\n\n**价格走势**：ETH 当前交易价格为 $3,420，正在 $3,400-$3,500 区间附近盘整...\n\n**链上指标**：活跃地址环比增长 12%，表明网络活动在增加...\n\n**交易策略**：可考虑在回调至 $3,300 支撑位时分批买入，目标位为 $3,600 和 $3,850..."
}

交易端点

意图兑换交易

端点： POST /x402/intent-to-swap-tx

将自然语言交易意图转换为可执行的兑换交易负载。默认兼容 OKX DEX。

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

描述

意图

字符串

是

自然语言兑换意图（例如：“将 0.1 ETH 换成 USDC”）

钱包地址

字符串

是

用户钱包地址（0x...）

链

字符串

否

链名称（例如 "base"、"ethereum"、"bsc"、"arbitrum"、"optimism"）

请求示例

curl -X POST https://x402.minara.ai/x402/intent-to-swap-tx \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "intent": "将 0.1 ETH 换成 USDC",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
    "chain": "base"
  }'

响应

状态： 201 已创建

{
  "transaction": {
    "chain": "base",
    "inputTokenAddress": "0x4200000000000000000000000000000000000006",
    "inputTokenSymbol": "ETH",
    "outputTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "outputTokenSymbol": "USDC",
    "amount": "0.1",
    "amountPercentage": 100,
    "slippagePercent": "0.5"
  }
}

永续合约交易建议

端点： POST /x402/perp-trading-suggestion

通过全面的市场分析，获取由 AI 驱动的永续合约交易建议，包括做多/做空建议、入场价、止损、止盈位以及置信度评分。

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

默认

描述

符号

字符串

是

交易符号（例如：“BTC”、“ETH”、“SOL”）

风格

字符串

否

"scalping"

交易风格："scalping"、"day-trading" 或 "swing-trading"

保证金美元

数字

否

1000

美元保证金

杠杆

数字

否

杠杆倍数（最大：40）

策略

字符串

否

"max-profit"

策略类型（更多策略即将推出）

请求示例

curl -X POST https://x402.minara.ai/x402/perp-trading-suggestion \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "symbol": "BTC",
    "style": "日内交易",
    "marginUSD": 1000,
    "leverage": 10,
    "strategy": "max-profit"
  }'

响应

状态： 201 已创建

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC 以强劲成交量突破了 $97,500 的关键阻力位",
    "RSI 位于 62，显示看涨动能但尚未超买",
    "MACD 在 4 小时时间框架上显示看涨交叉",
    "成交量分布显示当前水平存在吸筹"
  ],
  "risks": [
    "在 $100,000 心理阻力位附近可能出现回调",
    "即将到来的美联储会议周围预期波动性较高",
    "主要交易所的资金费率正呈上升趋势"
  ]
}

预测市场分析（Base 链）

端点： POST /x402/prediction-market-ask

由 AI 驱动的预测市场分析。分析预测市场事件，并为每个结果提供概率估计及详细推理。

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

默认

描述

链接

字符串

是

预测市场页面链接（例如 Polymarket 事件 URL）

模式

字符串

是

聊天模式："fast" 或 "expert"

仅结果

布尔值

否

假

仅返回预测概率，不提供推理

自定义提示

字符串

否

用于指导分析的自定义说明

请求示例

curl -X POST https://x402.minara.ai/x402/prediction-market-ask \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31",
    "mode": "快速",
    "only_result": false,
    "customPrompt": "重点关注近期新闻和情绪分析。概率估计请更保守一些。"
  }'

响应

状态： 201 已创建

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "根据近期民调数据和历史趋势，特朗普在关键摇摆州仍保持轻微领先。然而，这场竞选依然高度胶着，且不确定性很大..."
}

预测市场分析（Polygon 链）

端点： POST /x402/polygon/prediction-market-ask

Polygon 链上的 AI 预测市场分析。功能与 Base 链端点相同。

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

与上面的 Base 链端点相同。

请求示例

curl -X POST https://x402.minara.ai/x402/polygon/prediction-market-ask \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31",
    "mode": "快速",
    "only_result": false
  }'

响应

状态： 201 已创建

响应格式与 Base 链端点相同。

错误响应

402 需要支付

未提供支付凭证的初始请求将返回：

{
  "error": "payment_required",
  "message": "访问此资源需要支付",
  "paymentInstructions": {
    "amount": "0.20",
    "currency": "USDC",
    "recipient": "0x...",
    "chain": "base"
  }
}

401 未经授权

无效或已过期的支付证明：

{
  "error": "unauthorized",
  "message": "无效的支付响应令牌"
}

400 错误请求

无效的请求参数：

{
  "error": "bad_request",
  "message": "缺少必填参数：userQuery"
}

速率限制

x402 端点会按钱包地址进行速率限制：

AI 端点： 每分钟 60 次请求
交易端点： 每分钟 30 次请求

超过速率限制将返回：

{
  "error": "rate_limit_exceeded",
  "message": "请求过多。请在 30 秒后重试。",
  "retryAfter": 30
}

说明

所有 x402 端点在完成支付挑战后都需要 x-payment-response 该请求头
价格可能会根据网络状况变化
有关 x402 协议的更多信息，请参见 x402 文档

上一页API 参考（API Key）下一页流动性

最后更新于 16天前

这有帮助吗？