API Referansı (x402)

Geliştirici x402 API

Minara'nın x402 uç noktaları için Kullandıkça Öde modeliyle 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

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

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

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

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

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

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

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

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

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

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

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.

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

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

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

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

dize

Evet

Kullanıcı sorgu içeriği

Örnek İstek

curl -X POST https://x402.minara.ai/x402/chat \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "BTC'nin mevcut fiyatı nedir ve temel destek seviyeleri nelerdir?"
  }'

Cevap

Durum: 201 Oluşturuldu

{
  "content": "BTC şu anda 98.450 $ seviyesinde işlem görüyor. Temel destek seviyeleri 96.500 $ ve 94.200 $ seviyelerinde. 97.000 $ üzerine güçlü hacimle gerçekleşen son kırılım, yükselişin devam edebileceğini gösteriyor..."
}

Sohbet Uzmanı (Base Zinciri)

Uç Nokta: POST /x402/chat/expert

Minara AI'ya sor - Base zincirinde uzman modlu 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

dize

Evet

Kullanıcı sorgu içeriği

Örnek İstek

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 için zincir üstü metrikler ve işlem stratejisi dahil kapsamlı bir analiz sunun"
  }'

Cevap

Durum: 201 Oluşturuldu

{
  "content": "ETH için Kapsamlı Analiz:\n\n**Fiyat Hareketi**: ETH 3.420 $ seviyesinde işlem görüyor ve 3.400-3.500 $ aralığında konsolide oluyor...\n\n**Zincir Üstü Metrikler**: Aktif adresler hafta bazında %12 arttı; bu, ağ etkinliğinin büyüdüğünü gösteriyor...\n\n**İşlem Stratejisi**: 3.300 $ desteğine geri çekilmelerde alım yapmayı, 3.600 $ ve 3.850 $ hedeflerini değerlendirin..."
}

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

dize

Evet

Kullanıcı sorgu içeriği

Örnek İstek

curl -X POST https://x402.minara.ai/x402/solana/chat \\
  -H "x-payment-response: <payment_proof_token>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "Şu anda Solana üzerindeki en popüler tokenları göster"
  }'

Cevap

Durum: 201 Oluşturuldu

{
  "content": "En popüler Solana tokenları:\n1. WIF - %24 artış, 24 saatlik hacim 45 M$\n2. BONK - güçlü topluluk etkinliğiyle %18 artış\n3. JUP - son pump sonrası konsolidasyon, hacim 38 M$..."
}

Sohbet Uzmanı (Solana Zinciri)

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

Minara AI'ya sor - Solana zincirinde uzman modlu 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

dize

Evet

Kullanıcı sorgu içeriği

Örnek İstek

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 tokenı için likidite dağılımını ve balina hareketlerini analiz edin"
  }'

Cevap

Durum: 201 Oluşturuldu

{
  "content": "**JUP Token Ayrıntılı Analizi**\n\n**Likidite Dağılımı**: Başlıca DEX'ler arasındaki toplam likidite 125 M$ ve bunun %65'i 0,85-0,92 $ aralığında yoğunlaşıyor...\n\n**Balina Aktivitesi**: İlk 10 cüzdan arzın %34'ünü kontrol ediyor. Son 24 saatte toplam 4,2 M$ tutarında alım içeren 3 önemli balina işlemi tespit edildi...\n\n**Risk Değerlendirmesi**: 1,00 $ seviyesinin üzerinde orta düzey likidite riski. Pozisyon büyüklüğünü belirlerken bunu dikkate alın..."
}

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

dize

Evet

Kullanıcı sorgu içeriği

Örnek İstek

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'nin mevcut fiyatı nedir ve temel destek seviyeleri nelerdir?"
  }'

Cevap

Durum: 201 Oluşturuldu

{
  "content": "BTC şu anda 98.450 $ seviyesinde işlem görüyor. Temel destek seviyeleri 96.500 $ ve 94.200 $ seviyelerinde. 97.000 $ üzerine güçlü hacimle gerçekleşen son kırılım, yükselişin devam edebileceğini gösteriyor..."
}

Sohbet Uzmanı (Polygon Zinciri)

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

Minara AI'ya sor - Polygon zincirinde uzman modlu 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

dize

Evet

Kullanıcı sorgu içeriği

Örnek İstek

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 için zincir üstü metrikler ve işlem stratejisi dahil kapsamlı bir analiz sunun"
  }'

Cevap

Durum: 201 Oluşturuldu

{
  "content": "**Kapsamlı ETH Analizi**\n\n**Fiyat Hareketi**: ETH 3.420 $ seviyesinde işlem görüyor ve 3.400-3.500 $ aralığında konsolide oluyor...\n\n**Zincir Üstü Metrikler**: Aktif adresler hafta bazında %12 arttı; bu, ağ etkinliğinin büyüdüğünü gösteriyor...\n\n**İşlem Stratejisi**: 3.300 $ desteğine geri çekilmelerde alım yapmayı, 3.600 $ ve 3.850 $ hedeflerini değerlendirin..."
}

İşlem Uç Noktaları

Takas İşlemine Niyet

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

Doğal dildeki işlem niyetini çalıştırılabilir bir takas 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

niyet

dize

Evet

Doğal dilde takas niyeti (örn. "0.1 ETH'yi USDC'ye takas et")

cüzdanAdresi

dize

Evet

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

zincir

dize

Hayır

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

Örnek İstek

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'yi USDC'ye takas et",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
    "chain": "base"
  }'

Cevap

Durum: 201 Oluşturuldu

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

Sürekli Vadeli İşlem Önerisi

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

Kapsamlı piyasa analizine dayalı, long/short önerileri, giriş fiyatı, stop loss, take profit seviyeleri ve güven skoru içeren yapay zekâ destekli sürekli vadeli 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

sembol

dize

Evet

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

stil

dize

Hayır

"scalping"

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

marginUSD

sayı

Hayır

1000

USD cinsinden teminat

kaldıraç

sayı

Hayır

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

strateji

dize

Hayır

"max-profit"

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

Örnek İstek

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": "day-trading",
    "marginUSD": 1000,
    "leverage": 10,
    "strategy": "max-profit"
  }'

Cevap

Durum: 201 Oluşturuldu

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC, güçlü hacimle 97.500 $ seviyesindeki önemli direncin üzerine çıktı",
    "62 seviyesindeki RSI, aşırı alımda olmadan yükseliş momentumu gösteriyor",
    "MACD, 4 saatlik zaman diliminde yükseliş kesişimi gösteriyor",
    "Hacim profili, mevcut seviyelerde birikim olduğunu gösteriyor"
  ],
  "risks": [
    "100.000 $ psikolojik direncinde olası geri çekilme",
    "Yaklaşan Fed toplantısı çevresinde yüksek oynaklık bekleniyor",
    "Başlıca borsalardaki fonlama oranları yükseliş eğiliminde"
  ]
}

Tahmin Piyasası Analizi (Base Zinciri)

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

Yapay zekâ destekli tahmin piyasası analizi. Tahmin piyasası etkinliklerini analiz edin ve her sonuç için ayrıntılı gerekçelendirme 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

bağlantı

dize

Evet

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

mod

dize

Evet

Sohbet modu: "fast" veya "expert"

yalnızca_sonuç

boolean

Hayır

false

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

özelKomut

dize

Hayır

Analizi yönlendirmek için özel talimatlar

Örnek İstek

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": "fast",
    "only_result": false,
    "customPrompt": "Son haberler ve duygu analizine odaklanın. Olasılık tahminlerinde daha muhafazakâr olun."
  }'

Cevap

Durum: 201 Oluşturuldu

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "Son anket verilerine ve tarihsel trendlere dayanarak Trump, kilit salıncak eyaletlerde hafif bir üstünlüğe sahip. Ancak yarış, önemli belirsizliklerle son derece rekabetçi olmaya devam ediyor..."
}

Tahmin Piyasası Analizi (Polygon Zinciri)

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

Polygon zincirinde yapay zekâ destekli tahmin piyasası analizi. Base zinciri uç noktasıyla aynı işlevsellik.

İ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

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": "fast",
    "only_result": false
  }'

Cevap

Durum: 201 Oluşturuldu

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

Hata Yanıtları

402 Ödeme Gerekli

İlk istek, ödeme kimlik bilgileri olmadan şunu döndürür:

{
  "error": "payment_required",
  "message": "Bu kaynağa erişmek için ödeme gereklidir",
  "paymentInstructions": {
    "amount": "0.20",
    "currency": "USDC",
    "recipient": "0x...",
    "chain": "base"
  }
}

401 Yetkisiz

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

{
  "error": "unauthorized",
  "message": "Geçersiz ödeme yanıtı belirteci"
}

400 Hatalı İstek

Geçersiz istek parametreleri:

{
  "error": "bad_request",
  "message": "Eksik zorunlu parametre: userQuery"
}

Hız Sınırları

x402 uç noktaları cüzdan adresi başına hız sınırına tabidir:

Yapay Zekâ Uç Noktaları: dakikada 60 istek
İşlem Uç Noktaları: dakikada 30 istek

Hız sınırlarının aşılması durumunda şu döndürülür:

{
  "error": "rate_limit_exceeded",
  "message": "Çok fazla istek. Lütfen 30 saniye sonra tekrar deneyin.",
  "retryAfter": 30
}

Notlar

Tüm x402 uç noktaları şunu gerektirir: x-payment-response ödeme meydan okumasını tamamladıktan sonra başlık
Fiyatlar ağ koşullarına bağlı olarak değişebilir
x402 protokolü hakkında daha fazla bilgi için bkz. x402 Belgeleri

ÖncekiAPI Referansı (API Anahtarı)SonrakiLikidite

Son güncelleme 19 gün önce

Bu yararlı oldu mu?