Referencia de API (x402)

API x402 para desarrolladores

Especificaciones técnicas de los endpoints x402 de Minara usando el modelo de pago por uso.

URL base: https://x402.minara.ai

Chat (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

Autorizaciones

x-payment-responsestringRequerido

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

Cuerpo

userQuerystringRequerido

Required. User query content.

Respuestas

201

Successful response

application/json

contentstringOpcional

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

Autorizaciones

x-payment-responsestringRequerido

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

Cuerpo

userQuerystringRequerido

Required. User query content.

Respuestas

201

Successful response

application/json

contentstringOpcional

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

Chat (Polygon Chain)

post

Ask Minara AI - Intelligent crypto assistant

Autorizaciones

x-payment-responsestringRequerido

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

Cuerpo

userQuerystringRequerido

Required. User query content.

Respuestas

201

Successful response

application/json

contentstringOpcional

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

Autorizaciones

x-payment-responsestringRequerido

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

Cuerpo

userQuerystringRequerido

Required. User query content.

Respuestas

201

Successful response

application/json

contentstringOpcional

AI response content.

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

Autorizaciones

x-payment-responsestringRequerido

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

Cuerpo

userQuerystringRequerido

Required. User query content.

Respuestas

201

Successful response

application/json

contentstringOpcional

AI response content.

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

Autorizaciones

x-payment-responsestringRequerido

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

Cuerpo

userQuerystringRequerido

Required. User query content.

Respuestas

201

Successful response

application/json

contentstringOpcional

AI response content.

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.

Autorizaciones

x-payment-responsestringRequerido

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

Cuerpo

symbolstringRequerido

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

stylestring · enumOpcional

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

Default: scalpingValores posibles:

marginUSDnumberOpcional

Optional. Margin in USD. Default: 1000.

Default: 1000

leveragenumber · mín: 1 · máx: 40Opcional

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

Default: 10

strategystringOpcional

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

Default: max-profit

Respuestas

201

Successful response

application/json

entryPricenumberOpcional

Recommended entry price.

sidestring · enumOpcional

Trading side recommendation.

Valores posibles:

stopLossPricenumberOpcional

Recommended stop loss price.

takeProfitPricenumberOpcional

Recommended take profit price.

confidencenumber · máx: 100Opcional

Confidence score (0-100).

reasonsstring[]Opcional

Analysis reasons based on technical indicators.

risksstring[]Opcional

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.

Autorizaciones

x-payment-responsestringRequerido

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

Cuerpo

intentstringRequerido

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

walletAddressstringRequerido

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

chainstringOpcional

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

Respuestas

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.

Autorizaciones

x-payment-responsestringRequerido

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

Cuerpo

linkstringRequerido

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

modestring · enumRequerido

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

Valores posibles:

only_resultbooleanOpcional

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

Default: false

customPromptstringOpcional

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

Respuestas

201

Successful response

application/json

reasoningstringOpcional

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

Endpoints

Chat (cadena Base)

Punto final: POST /x402/chat

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Parámetro

Tipo

Requerido

Descripción

userQuery

cadena

Sí

Contenido de la consulta del usuario

Solicitud de ejemplo

curl -X POST https://x402.minara.ai/x402/chat \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "¿Cuál es el precio actual de BTC y cuáles son los niveles clave de soporte?"
  }'

Respuesta

Estado: 201 Creado

{
  "content": "BTC cotiza actualmente a $98,450. Los niveles clave de soporte están en $96,500 y $94,200. El reciente rompimiento por encima de $97,000 con fuerte volumen sugiere continuidad alcista..."
}

Chat experto (cadena Base)

Punto final: POST /x402/chat/expert

Pregúntale a Minara AI - asistente cripto inteligente en la cadena Base con modo experto

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Parámetro

Tipo

Requerido

Descripción

userQuery

cadena

Sí

Contenido de la consulta del usuario

Solicitud de ejemplo

curl -X POST https://x402.minara.ai/x402/chat/expert \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "Proporciona un análisis completo de ETH incluyendo métricas on-chain y estrategia de trading"
  }'

Respuesta

Estado: 201 Creado

{
  "content": "Análisis completo de ETH:\n\n**Acción del precio**: ETH cotiza a $3,420, consolidándose cerca del rango de $3,400-$3,500...\n\n**Métricas on-chain**: Las direcciones activas aumentaron un 12% semana a semana, lo que indica una actividad creciente en la red...\n\n**Estrategia de trading**: Considera acumular en las caídas hacia el soporte de $3,300 con objetivos en $3,600 y $3,850..."
}

Chat (cadena Solana)

Punto final: POST /x402/solana/chat

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Parámetro

Tipo

Requerido

Descripción

userQuery

cadena

Sí

Contenido de la consulta del usuario

Solicitud de ejemplo

curl -X POST https://x402.minara.ai/x402/solana/chat \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "Muéstrame los tokens en tendencia más destacados en Solana ahora mismo"
  }'

Respuesta

Estado: 201 Creado

{
  "content": "Principales tokens de Solana en tendencia:\n1. WIF - sube 24% con $45M de volumen en 24h\n2. BONK - sube 18% con fuerte actividad de la comunidad\n3. JUP - consolidándose tras el reciente impulso, volumen en $38M..."
}

Chat experto (cadena Solana)

Punto final: POST /x402/solana/chat/expert

Pregúntale a Minara AI - asistente cripto inteligente en la cadena Solana con modo experto

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Parámetro

Tipo

Requerido

Descripción

userQuery

cadena

Sí

Contenido de la consulta del usuario

Solicitud de ejemplo

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": "Analiza la distribución de liquidez y los movimientos de ballenas para el token JUP"
  }'

Respuesta

Estado: 201 Creado

{
  "content": "**Análisis profundo del token JUP**\n\n**Distribución de liquidez**: La liquidez total en los principales DEX es de $125M, con el 65% concentrado en el rango de $0.85-$0.92...\n\n**Actividad de ballenas**: Los 10 principales holders controlan el 34% de la oferta. Se detectaron 3 transacciones significativas de ballenas en las últimas 24h por un total de $4.2M en compras...\n\n**Evaluación del riesgo**: Riesgo moderado de liquidez por encima del nivel de $1.00. Tenlo en cuenta al dimensionar la posición..."
}

Chat (cadena Polygon)

Punto final: POST /x402/polygon/chat

Pregúntale a Minara AI - asistente cripto inteligente en la cadena Polygon

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Parámetro

Tipo

Requerido

Descripción

userQuery

cadena

Sí

Contenido de la consulta del usuario

Solicitud de ejemplo

curl -X POST https://x402.minara.ai/x402/polygon/chat \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \\
  -d '{
    "userQuery": "¿Cuál es el precio actual de BTC y cuáles son los niveles clave de soporte?"
  }'

Respuesta

Estado: 201 Creado

{
  "content": "BTC cotiza actualmente a $98,450. Los niveles clave de soporte están en $96,500 y $94,200. El reciente rompimiento por encima de $97,000 con fuerte volumen sugiere continuidad alcista..."
}

Chat experto (cadena Polygon)

Punto final: POST /x402/polygon/chat/expert

Pregúntale a Minara AI - asistente cripto inteligente en la cadena Polygon con modo experto

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Parámetro

Tipo

Requerido

Descripción

userQuery

cadena

Sí

Contenido de la consulta del usuario

Solicitud de ejemplo

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": "Proporciona un análisis completo de ETH incluyendo métricas on-chain y estrategia de trading"
  }'

Respuesta

Estado: 201 Creado

{
  "content": "**Análisis completo de ETH**\n\n**Acción del precio**: ETH cotiza a $3,420, consolidándose cerca del rango de $3,400-$3,500...\n\n**Métricas on-chain**: Las direcciones activas aumentaron un 12% semana a semana, lo que indica una actividad creciente en la red...\n\n**Estrategia de trading**: Considera acumular en las caídas hacia el soporte de $3,300 con objetivos en $3,600 y $3,850..."
}

Endpoints de trading

Transacción de intención de swap

Punto final: POST /x402/intent-to-swap-tx

Convierte una intención de trading en lenguaje natural en un payload de transacción de swap ejecutable. Compatible con OKX DEX por defecto.

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Parámetro

Tipo

Requerido

Descripción

intent

cadena

Sí

Intención de intercambio en lenguaje natural (p. ej., "intercambia 0,1 ETH por USDC")

walletAddress

cadena

Sí

Dirección de la wallet del usuario (0x...)

chain

cadena

Nombre de la cadena (p. ej., "base", "ethereum", "bsc", "arbitrum", "optimism")

Solicitud de ejemplo

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": "intercambia 0,1 ETH por USDC",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
    "chain": "base"
  }'

Respuesta

Estado: 201 Creado

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

Sugerencia de trading perpetuo

Punto final: POST /x402/perp-trading-suggestion

Obtén sugerencias de trading perpetuo impulsadas por IA con recomendaciones de largo/corto, precio de entrada, stop loss, niveles de take profit y puntuación de confianza basada en un análisis de mercado integral.

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Parámetro

Tipo

Requerido

Predeterminado

Descripción

símbolo

cadena

Sí

Símbolo de trading (p. ej., "BTC", "ETH", "SOL")

estilo

cadena

"scalping"

Estilo de trading: "scalping", "day-trading" o "swing-trading"

marginUSD

número

1000

Margen en USD

leverage

número

Multiplicador de apalancamiento (máx.: 40)

strategy

cadena

"max-profit"

Tipo de estrategia (más estrategias próximamente)

Solicitud de ejemplo

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

Respuesta

Estado: 201 Creado

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC rompió por encima de la resistencia clave en $97,500 con fuerte volumen",
    "El RSI en 62 indica impulso alcista sin estar sobrecomprado",
    "El MACD muestra un cruce alcista en el marco temporal de 4H",
    "El perfil de volumen muestra acumulación en los niveles actuales"
  ],
  "risks": [
    "Posible retroceso en la resistencia psicológica de $100,000",
    "Se espera alta volatilidad alrededor de la próxima reunión de la Fed",
    "Las tasas de financiación en los principales exchanges están tendiendo al alza"
  ]
}

Análisis del mercado de predicción (cadena Base)

Punto final: POST /x402/prediction-market-ask

Análisis de mercado de predicción impulsado por IA. Analiza eventos de mercados de predicción y obtén estimaciones de probabilidad para cada resultado con razonamiento detallado.

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Parámetro

Tipo

Requerido

Predeterminado

Descripción

link

cadena

Sí

Enlace de la página del mercado de predicción (p. ej., URL de un evento de Polymarket)

mode

cadena

Sí

Modo de chat: "fast" o "expert"

only_result

booleano

falso

Devuelve solo las probabilidades de predicción sin razonamiento

customPrompt

cadena

Instrucciones personalizadas para guiar el análisis

Solicitud de ejemplo

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": "Céntrate en las noticias recientes y en el análisis de sentimiento. Sé más conservador en las estimaciones de probabilidad."
  }'

Respuesta

Estado: 201 Creado

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "Basado en datos recientes de encuestas y tendencias históricas, Trump mantiene una ligera ventaja en los principales estados decisivos. Sin embargo, la carrera sigue siendo muy competitiva con una incertidumbre significativa..."
}

Análisis del mercado de predicción (cadena Polygon)

Punto final: POST /x402/polygon/prediction-market-ask

Análisis de mercado de predicción impulsado por IA en la cadena Polygon. La misma funcionalidad que el endpoint de la cadena Base.

Solicitud

Encabezados:

x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402
Content-Type: application/json

Parámetros del cuerpo:

Igual que el endpoint de la cadena Base de arriba.

Solicitud de ejemplo

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
  }'

Respuesta

Estado: 201 Creado

Mismo formato de respuesta que el endpoint de la cadena Base.

Respuestas de error

402 Pago requerido

La solicitud inicial sin credenciales de pago devolverá:

{
  "error": "payment_required",
  "message": "Se requiere pago para acceder a este recurso",
  "paymentInstructions": {
    "amount": "0.20",
    "currency": "USDC",
    "recipient": "0x...",
    "chain": "base"
  }
}

401 No autorizado

Prueba de pago inválida o caducada:

{
  "error": "unauthorized",
  "message": "Token de respuesta de pago inválido"
}

400 Solicitud incorrecta

Parámetros de solicitud inválidos:

{
  "error": "bad_request",
  "message": "Falta el parámetro obligatorio: userQuery"
}

Límites de tasa

Los endpoints x402 tienen límite de tasa por dirección de billetera:

Endpoints de IA: 60 solicitudes por minuto
Endpoints de trading: 30 solicitudes por minuto

Superar los límites de tasa devolverá:

{
  "error": "rate_limit_exceeded",
  "message": "Demasiadas solicitudes. Por favor, inténtalo de nuevo en 30 segundos.",
  "retryAfter": 30
}

Notas

Todos los endpoints x402 requieren el x-payment-response encabezado después de completar el desafío de pago
Los precios están sujetos a cambios según las condiciones de la red
Para obtener más información sobre el protocolo x402, consulta Documentación de x402

AnteriorReferencia de API (Clave API)SiguienteLiquidez

Última actualización hace 1 mes

¿Te fue útil?