API Referansı (x402)

Geliştirici x402 API

Pay-As-You-Go modelini kullanan Minara'nın x402 uç noktaları için teknik özellikler.

Temel 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

Uç Noktalar

Sohbet (Base Zinciri)

Uç Nokta: POST /x402/chat

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Parametre
Tür
Gerekli
Açıklama

userQuery

string

Evet

Kullanıcı sorgusu içeriği

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu


Sohbet Uzmanı (Base Zinciri)

Uç Nokta: POST /x402/chat/expert

Minara AI'ya Sor - Uzman modlu Base zincirinde akıllı kripto asistanı

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Parametre
Tür
Gerekli
Açıklama

userQuery

string

Evet

Kullanıcı sorgusu içeriği

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu


Sohbet (Solana Zinciri)

Uç Nokta: POST /x402/solana/chat

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Parametre
Tür
Gerekli
Açıklama

userQuery

string

Evet

Kullanıcı sorgusu içeriği

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu

Sohbet Uzmanı (Solana Zinciri)

Uç Nokta: POST /x402/solana/chat/expert

Minara AI'ya Sor - Uzman modlu Solana zincirinde akıllı kripto asistanı

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Parametre
Tür
Gerekli
Açıklama

userQuery

string

Evet

Kullanıcı sorgusu içeriği

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu


Sohbet (Polygon Zinciri)

Uç Nokta: POST /x402/polygon/chat

Minara AI'ya Sor - Polygon zincirinde akıllı kripto asistanı

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Parametre
Tür
Gerekli
Açıklama

userQuery

string

Evet

Kullanıcı sorgusu içeriği

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu


Sohbet Uzmanı (Polygon Zinciri)

Uç Nokta: POST /x402/polygon/chat/expert

Minara AI'ya Sor - Uzman modlu Polygon zincirinde akıllı kripto asistanı

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Parametre
Tür
Gerekli
Açıklama

userQuery

string

Evet

Kullanıcı sorgusu içeriği

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu


Ticaret Uç Noktaları

Swap Niyeti İşlemi

Uç Nokta: POST /x402/intent-to-swap-tx

Doğal dildeki ticaret niyetini yürütülebilir bir swap işlem yüküne dönüştürün. Varsayılan olarak OKX DEX ile uyumludur.

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Parametre
Tür
Gerekli
Açıklama

intent

string

Evet

Doğal dil swap niyeti (ör. "0.1 ETH'yi USDC'ye takas et")

walletAddress

string

Evet

Kullanıcı cüzdan adresi (0x...)

chain

string

Hayır

Zincir adı (ör. "base", "ethereum", "bsc", "arbitrum", "optimism")

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu


Sürekli Vadeli İşlem Tavsiyesi

Uç Nokta: POST /x402/perp-trading-suggestion

Kapsamlı piyasa analizine dayalı olarak long/short önerileri, giriş fiyatı, stop loss, take profit seviyeleri ve güven puanı içeren yapay zekâ destekli perpetual işlem önerileri alın.

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Parametre
Tür
Gerekli
Varsayılan
Açıklama

symbol

string

Evet

-

İşlem sembolü (ör. "BTC", "ETH", "SOL")

style

string

Hayır

"scalping"

İşlem stili: "scalping", "day-trading" veya "swing-trading"

marginUSD

sayı

Hayır

1000

USD cinsinden marj

leverage

sayı

Hayır

10

Kaldıraç çarpanı (maks: 40)

strategy

string

Hayır

"max-profit"

Strateji türü (daha fazla strateji yakında eklenecek)

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu


Tahmin Pazarı Analizi (Base Zinciri)

Uç Nokta: POST /x402/prediction-market-ask

Yapay zekâ destekli tahmin pazarı analizi. Tahmin pazarı olaylarını analiz edin ve her sonuç için ayrıntılı gerekçe ile olasılık tahminleri alın.

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Parametre
Tür
Gerekli
Varsayılan
Açıklama

link

string

Evet

-

Tahmin pazarı sayfa bağlantısı (ör. Polymarket etkinlik URL'si)

mode

string

Evet

-

Sohbet modu: "fast" veya "expert"

only_result

boolean

Hayır

false

Sadece gerekçe olmadan tahmin olasılıklarını döndür

customPrompt

string

Hayır

-

Analizi yönlendirmek için özel talimatlar

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu


Tahmin Pazarı Analizi (Polygon Zinciri)

Uç Nokta: POST /x402/polygon/prediction-market-ask

Polygon zincirinde yapay zekâ destekli tahmin pazarı analizi. Base zinciri uç noktasının aynı işlevselliği.

İstek

Başlıklar:

  • x-payment-response (gerekli) - x402 protokolünden ödeme kanıtı belirteci

  • Content-Type: application/json

Gövde Parametreleri:

Yukarıdaki Base zinciri uç noktası ile aynı.

Örnek İstek

Yanıt

Durum: 201 Oluşturuldu

Base zinciri uç noktasının aynı yanıt formatı.


Hata Yanıtları

402 Ödeme Gerekli

Ödeme kimlik bilgileri olmadan yapılan ilk istek şu şekilde döner:

401 Yetkisiz

Geçersiz veya süresi dolmuş ödeme kanıtı:

400 Bad Request

Geçersiz istek parametreleri:


Oran Sınırları

x402 uç noktaları cüzdan adresi başına oran sınırlamasına tabidir:

  • AI Uç Noktaları: dakikada 60 istek

  • Ticaret Uç Noktaları: dakikada 30 istek

Oran sınırlarını aşmak şu yanıtı döndürecektir:


Notlar

  • Tüm x402 uç noktaları x-payment-response ödeme zorluğunu tamamladıktan sonra başlığı gerektirir

  • Fiyatlar ağ koşullarına bağlı olarak değişebilir

  • x402 protokolü hakkında daha fazla bilgi için bkz x402 Dokümantasyonuarrow-up-right

Last updated

Was this helpful?