API 참조 (x402)

Developer x402 API

종량제(Pay-As-You-Go) 모델을 사용하는 Minara의 x402 엔드포인트에 대한 기술 사양입니다.

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

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
post
/x402/chat

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
post
/x402/chat/expert

Chat (Polygon 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
post
/x402/polygon/chat

Chat Expert (Polygon 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
post
/x402/polygon/chat/expert

Chat (Solana 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
post
/x402/solana/chat

Chat Expert (Solana 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
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.

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

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

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
post
/x402/prediction-market-ask

엔드포인트

채팅 (Base 체인)

엔드포인트: POST /x402/chat

요청

헤더:

  • x-payment-response (필수) - x402 프로토콜의 결제 증명 토큰

  • Content-Type: application/json

본문 매개변수:

매개변수
유형
필수 여부
설명

userQuery

string

사용자 쿼리 내용

예시 요청

응답

상태: 201 Created


채팅 전문가 (Base 체인)

엔드포인트: POST /x402/chat/expert

Minara AI에게 묻기 - 전문가 모드의 Base 체인 지능형 암호화폐 어시스턴트

요청

헤더:

  • x-payment-response (필수) - x402 프로토콜의 결제 증명 토큰

  • Content-Type: application/json

본문 매개변수:

매개변수
유형
필수 여부
설명

userQuery

string

사용자 쿼리 내용

예시 요청

응답

상태: 201 Created


채팅 (Solana 체인)

엔드포인트: POST /x402/solana/chat

요청

헤더:

  • x-payment-response (필수) - x402 프로토콜의 결제 증명 토큰

  • Content-Type: application/json

본문 매개변수:

매개변수
유형
필수 여부
설명

userQuery

string

사용자 쿼리 내용

예시 요청

응답

상태: 201 Created

채팅 전문가 (Solana 체인)

엔드포인트: POST /x402/solana/chat/expert

Minara AI에게 묻기 - 전문가 모드의 Solana 체인 지능형 암호화폐 어시스턴트

요청

헤더:

  • x-payment-response (필수) - x402 프로토콜의 결제 증명 토큰

  • Content-Type: application/json

본문 매개변수:

매개변수
유형
필수 여부
설명

userQuery

string

사용자 쿼리 내용

예시 요청

응답

상태: 201 Created


채팅 (Polygon 체인)

엔드포인트: POST /x402/polygon/chat

Minara AI에게 묻기 - Polygon 체인의 지능형 암호화폐 어시스턴트

요청

헤더:

  • x-payment-response (필수) - x402 프로토콜의 결제 증명 토큰

  • Content-Type: application/json

본문 매개변수:

매개변수
유형
필수 여부
설명

userQuery

string

사용자 쿼리 내용

예시 요청

응답

상태: 201 Created


채팅 전문가 (Polygon 체인)

엔드포인트: POST /x402/polygon/chat/expert

Minara AI에게 묻기 - 전문가 모드의 Polygon 체인 지능형 암호화폐 어시스턴트

요청

헤더:

  • x-payment-response (필수) - x402 프로토콜의 결제 증명 토큰

  • Content-Type: application/json

본문 매개변수:

매개변수
유형
필수 여부
설명

userQuery

string

사용자 쿼리 내용

예시 요청

응답

상태: 201 Created


거래 엔드포인트

스왑 의도 트랜잭션

엔드포인트: 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) 거래 제안

엔드포인트: POST /x402/perp-trading-suggestion

롱/숏 추천, 진입가, 손절, 익절 수준 및 포괄적 시장 분석 기반의 신뢰 점수를 포함한 AI 기반 무기한 거래 제안을 제공합니다.

요청

헤더:

  • 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


예측 시장 분석 (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


예측 시장 분석 (Polygon 체인)

엔드포인트: POST /x402/polygon/prediction-market-ask

Polygon 체인에서의 AI 기반 예측 시장 분석입니다. Base 체인 엔드포인트와 동일한 기능을 제공합니다.

요청

헤더:

  • x-payment-response (필수) - x402 프로토콜의 결제 증명 토큰

  • Content-Type: application/json

본문 매개변수:

위의 Base 체인 엔드포인트와 동일합니다.

예시 요청

응답

상태: 201 Created

Base 체인 엔드포인트와 동일한 응답 형식입니다.


오류 응답

402 결제 필요

결제 자격 증명 없이 초기 요청을 보낼 경우 다음을 반환합니다:

401 Unauthorized

유효하지 않거나 만료된 결제 증명:

400 Bad Request

잘못된 요청 매개변수:


요율 제한(Rate Limits)

x402 엔드포인트는 지갑 주소별로 속도 제한이 적용됩니다:

  • AI 엔드포인트: 분당 60건의 요청

  • 거래 엔드포인트: 분당 30건의 요청

속도 제한을 초과하면 다음을 반환합니다:


참고

  • 모든 x402 엔드포인트는 결제 챌린지를 완료한 후 x-payment-response 헤더를 요구합니다

  • 가격은 네트워크 상황에 따라 변경될 수 있습니다

  • x402 프로토콜에 대한 자세한 정보는 x402 문서arrow-up-right

마지막 업데이트

도움이 되었나요?