x402

x402는 구독이 필요 없는 사용량 기반 API 접근 방식입니다. Base, Solana 또는 Polygon에서 USDC 같은 스테이블코인을 사용해 각 호출마다 직접 결제합니다.

Minara x402 엔드포인트: https://x402.minara.ai

모든 엔드포인트 살펴보기: x402scan에서 Minara

x402 작동 방식

x402는 결제-챌린지 흐름을 따릅니다:

결제 없이 보호된 엔드포인트에 요청을 보냅니다.
서버는 다음과 같이 응답합니다 402 Payment Required 그리고 결제 안내(금액, 통화, 수신 주소, 체인)를 제공합니다.
다음에 결제 증명을 포함합니다 x-payment-response 헤더에 넣고 요청을 다시 보냅니다.
서버가 증명을 검증하고, 체인상에서 결제를 처리한 뒤, API 응답을 반환합니다.

권장되는 방법은 이 흐름을 자동으로 처리하는 x402 SDK를 사용하는 것입니다.

SDK 시작하기

사전 요구 사항

USDC가 있는 암호화폐 지갑(EVM 호환 지갑 또는 Solana 지갑)
Node.js / Python / Go
지갑의 개인 키(결제 서명용)

설치

npm install @x402/fetch @x402/evm

요청 보내기

SDK가 결제 챌린지를 자동으로 처리합니다. 그냥 평소처럼 요청을 보내세요.

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

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

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)
// 결제는 자동으로 처리됩니다

전체 x402 빠른 시작은 다음을 참조하세요 x402 문서.

API 참고 문서

기본 URL: https://x402.minara.ai

모든 엔드포인트는 x-payment-response 헤더를 필요로 합니다(SDK가 자동으로 처리).

Chat (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

Authorizations

x-payment-responsestringRequired

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

Body

userQuerystringRequired

Required. User query content.

Responses

201

Successful response

application/json

contentstringOptional

AI response content.

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

Authorizations

x-payment-responsestringRequired

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

Body

userQuerystringRequired

Required. User query content.

Responses

201

Successful response

application/json

contentstringOptional

AI response content.

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]..."
}

Perpetual Trading Suggestion

post

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

Authorizations

x-payment-responsestringRequired

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

Body

symbolstringRequired

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

stylestring · enumOptional

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

Default: scalpingPossible values:

marginUSDnumberOptional

Optional. Margin in USD. Default: 1000.

Default: 1000

leveragenumber · min: 1 · max: 40Optional

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

Default: 10

strategystringOptional

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

Default: max-profit

Responses

201

Successful response

application/json

entryPricenumberOptional

Recommended entry price.

sidestring · enumOptional

Trading side recommendation.

Possible values:

stopLossPricenumberOptional

Recommended stop loss price.

takeProfitPricenumberOptional

Recommended take profit price.

confidencenumber · max: 100Optional

Confidence score (0-100).

reasonsstring[]Optional

Analysis reasons based on technical indicators.

risksstring[]Optional

Risk factors to consider.

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.

Authorizations

x-payment-responsestringRequired

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

Body

intentstringRequired

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

walletAddressstringRequired

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

chainstringOptional

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

Responses

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.

Authorizations

x-payment-responsestringRequired

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

Body

linkstringRequired

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

modestring · enumRequired

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

Possible values:

only_resultbooleanOptional

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

Default: false

customPromptstringOptional

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

Responses

201

Successful response

application/json

reasoningstringOptional

AI reasoning and analysis (empty if only_result=true).

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..."
}

멀티체인 엔드포인트

Solana와 Polygon 버전은 다음에서 사용할 수 있습니다 /x402/solana/chat, /x402/solana/chat/expert, /x402/polygon/chat, 그리고 /x402/polygon/chat/expert 동일한 요청/응답 형식으로 제공됩니다.

오류 처리

코드

오류

의미

402

payment_required

정상 — SDK가 이를 자동으로 처리합니다

401

unauthorized

결제 증명이 유효하지 않거나 만료됨

400

bad_request

요청 매개변수가 없거나 유효하지 않음

429

rate_limit_exceeded

AI 엔드포인트: 분당 60회 요청; 트레이딩 엔드포인트: 분당 30회 요청

리소스

이전API 키 다음API 레퍼런스(API 키)

마지막 업데이트 2개월 전

도움이 되었나요?