APIリファレンス(x402)

Developer x402 API

Pay-As-You-Goモデルを使用するMinaraのx402エンドポイントに関する技術仕様。

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

レスポンス
post
/x402/chat

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.

レスポンス
post
/x402/chat/expert

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.

レスポンス
post
/x402/polygon/chat

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.

レスポンス
post
/x402/polygon/chat/expert

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.

レスポンス
post
/x402/solana/chat

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.

レスポンス
post
/x402/solana/chat/expert

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
レスポンス
post
/x402/perp-trading-suggestion

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

レスポンス
post
/x402/intent-to-swap-tx

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.

レスポンス
post
/x402/prediction-market-ask

Endpoints

Chat(Baseチェーン)

エンドポイント: POST /x402/chat

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

パラメータ
必須
説明

userQuery

string

はい

ユーザーの問い合わせ内容

リクエスト例

レスポンス

ステータス: 201 Created


Chat Expert(Baseチェーン)

エンドポイント: POST /x402/chat/expert

Ask Minara AI - Baseチェーン上のエキスパートモード搭載のインテリジェントな暗号通貨アシスタント

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

パラメータ
必須
説明

userQuery

string

はい

ユーザーの問い合わせ内容

リクエスト例

レスポンス

ステータス: 201 Created


Chat(Solanaチェーン)

エンドポイント: POST /x402/solana/chat

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

パラメータ
必須
説明

userQuery

string

はい

ユーザーの問い合わせ内容

リクエスト例

レスポンス

ステータス: 201 Created

Chat Expert(Solanaチェーン)

エンドポイント: POST /x402/solana/chat/expert

Ask Minara AI - Solanaチェーン上のエキスパートモード搭載のインテリジェントな暗号通貨アシスタント

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

パラメータ
必須
説明

userQuery

string

はい

ユーザーの問い合わせ内容

リクエスト例

レスポンス

ステータス: 201 Created


Chat(Polygonチェーン)

エンドポイント: POST /x402/polygon/chat

Ask Minara AI - Polygonチェーン上のインテリジェントな暗号通貨アシスタント

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

パラメータ
必須
説明

userQuery

string

はい

ユーザーの問い合わせ内容

リクエスト例

レスポンス

ステータス: 201 Created


Chat Expert(Polygonチェーン)

エンドポイント: POST /x402/polygon/chat/expert

Ask Minara AI - Polygonチェーン上のエキスパートモード搭載のインテリジェントな暗号通貨アシスタント

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

パラメータ
必須
説明

userQuery

string

はい

ユーザーの問い合わせ内容

リクエスト例

レスポンス

ステータス: 201 Created


Trading Endpoints

Intent to Swap Transaction

エンドポイント: POST /x402/intent-to-swap-tx

自然言語の取引意図を実行可能なスワップトランザクションペイロードに変換します。デフォルトでOKX DEXと互換性があります。

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

パラメータ
必須
説明

intent

string

はい

自然言語のスワップ意図(例:「swap 0.1 ETH to USDC」)

walletAddress

string

はい

ユーザーのウォレットアドレス(0x...)

chain

string

いいえ

チェーン名(例:「base」、「ethereum」、「bsc」、「arbitrum」、「optimism」)

リクエスト例

レスポンス

ステータス: 201 Created


Perpetual Trading Suggestion

エンドポイント: POST /x402/perp-trading-suggestion

ロング/ショートの推奨、エントリ価格、ストップロス、テイクプロフィットレベル、信頼度スコアを含むAIによる永久先物(perpetual)取引の提案を、包括的な市場分析に基づいて取得します。

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

パラメータ
必須
デフォルト
説明

symbol

string

はい

-

取引シンボル(例:「BTC」、「ETH」、「SOL」)

style

string

いいえ

"scalping"

取引スタイル:「scalping」、「day-trading」、または「swing-trading」

marginUSD

number

いいえ

1000

USDでの証拠金

leverage

number

いいえ

10

レバレッジ倍率(最大:40)

strategy

string

いいえ

"max-profit"

戦略タイプ(今後さらに戦略を追加予定)

リクエスト例

レスポンス

ステータス: 201 Created


Prediction Market Analysis(Baseチェーン)

エンドポイント: POST /x402/prediction-market-ask

AIによる予測市場分析。予測市場イベントを分析し、各結果の確率推定と詳細な根拠を取得します。

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

パラメータ
必須
デフォルト
説明

link

string

はい

-

予測市場ページのリンク(例:PolymarketのイベントURL)

mode

string

はい

-

チャットモード:「fast」または「expert」

only_result

boolean

いいえ

false

推論なしで確率のみを返す

customPrompt

string

いいえ

-

分析を導くためのカスタム指示

リクエスト例

レスポンス

ステータス: 201 Created


Prediction Market Analysis(Polygonチェーン)

エンドポイント: POST /x402/polygon/prediction-market-ask

Polygonチェーン上でのAIによる予測市場分析。Baseチェーンのエンドポイントと同等の機能です。

リクエスト

ヘッダー:

  • x-payment-response (必須)- x402プロトコルからの支払い証明トークン

  • Content-Type: application/json

ボディパラメータ:

上記のBaseチェーンエンドポイントと同じです。

リクエスト例

レスポンス

ステータス: 201 Created

Baseチェーンエンドポイントと同じレスポンス形式です。


エラー応答

402 Payment Required

支払い認証情報なしでの初回リクエストは次を返します:

401 Unauthorized

無効または期限切れの支払い証明:

400 Bad Request

無効なリクエストパラメータ:


レート制限

x402エンドポイントはウォレットアドレスごとにレート制限されます:

  • AIエンドポイント: 1分あたり60リクエスト

  • 取引エンドポイント: 1分あたり30リクエスト

レート制限を超えると次を返します:


注意事項

  • すべてのx402エンドポイントは、 x-payment-response 支払いチャレンジ完了後にヘッダーを要求します

  • 価格はネットワーク状況に応じて変動する場合があります

  • x402プロトコルの詳細については、次を参照してください x402 Documentationarrow-up-right

最終更新

役に立ちましたか?