Warppay402

npx add-mcp 'https://api.warppay402.com/mcp?v=2'

docs.warppay402.com

Documentación para Desarrolladores de WarpPay402

Servidor de monetización x402 sin custodia y puerta de enlace multi-cadena de herramientas para agentes de IA autónomos.

Bienvenido a la documentación para desarrolladores de WarpPay402. WarpPay402 permite a agentes de IA, scripts y desarrolladores acceder a scraping web de alto valor, análisis de PDF, verificaciones de contratos inteligentes, ejecución de rendimientos de Aerodrome y transferencias entre cadenas de Circle CCTP sin gestionar claves API ni cuentas de suscripción.

• Descripción general
• Autenticación (Micropagos x402)
• Inicio rápido: Python
• Inicio rápido: TypeScript
• Integración con MCP y Claude
• Referencia completa de la API (21 herramientas)
• Paymaster sin gas (v0.8)
• Soporte y asistencia
• Endpoints de descubrimiento para servidores MCP y agentes de IA

DESCRIPCIÓN GENERAL

Las APIs SaaS tradicionales requieren registro, tarjetas de crédito, generación manual de claves API y gestión de tokens. WarpPay402 utiliza el protocolo x402 para eliminar esta fricción por completo.

Sin claves API ni registros: Los agentes interactúan directamente con endpoints monetizados.

Micropagos de pago por uso: Las solicitudes cuestan fracciones de centavo ($0.0001 a $5.00 USDC) firmadas mediante autorizaciones criptográficas en cadena (EIP-712 / EIP-3009).

Multi-cadena nativo: Compatible con Base Mainnet, Solana Mainnet, Arbitrum One y Arc Mainnet.

Autenticación (Micropagos x402)

WarpPay402 no utiliza tokens Bearer ni cabeceras estáticas. En su lugar, la autenticación utiliza un flujo automatizado de solicitudes HTTP en 2 pasos:

[ Agente de IA / Script ] [ Puerta de enlace WarpPay402 ]

│ │

│────── 1. POST /api/v1/tools/web-scraper ─────────►│ (No pagado)

│ │

│◄───── 2. HTTP 402 Payment Required ───────────────│ (Devuelve desafío x402)

│ (Cabecera: PAYMENT-REQUIRED) │

│ │

│────── 3. POST /api/v1/tools/web-scraper ─────────►│ (Pagado)

│ (Cabecera: PAYMENT-SIGNATURE) │

│ │

│◄───── 4. HTTP 200 OK + Salida de la herramienta ──│

Redes de pago compatibles

Red ID CAIP-2 Token nativo / Activo

Base Mainnet eip155:8453 USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)

Solana Mainnet solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp SPL USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)

Arc Mainnet eip155:5042 USDC nativo (0x0000000000000000000000000000000000000000)

Arbitrum One eip155:42161 USDC (0xaf88d065e77c8cC2239327C5EDb3A432268e5831)

Inicio rápido: Python

(1) Instale el SDK oficial de Python desde PyPI:

Bash

pip install warppay402-mcp

(2) Ejemplo de código:

from warppay402 import WarpPayClient

# Inicializar el cliente con la clave privada de su cartera

client = WarpPayClient(

private_key="0x_YOUR_AGENT_PRIVATE_KEY",

gateway_url="https://api.warppay402.com"

)

# Ejecutar el Web Scraper de Markdown ($0.001 USDC)

result = client.call_tool(

"web_scraper",

payload={"url": "https://news.ycombinator.com"}

)

print(f"Título: {result['title']}")

print(f"Vista previa de Markdown:\n{result['markdown'][:500]}")

Inicio rápido: TypeScript

(1) Instale el paquete oficial del cliente Node.js:

Bash

npm install @warppay402/sdk

(2) Ejemplo de código

import { WarpPayClient } from "@warppay402/sdk";

const client = new WarpPayClient({

privateKey: process.env.AGENT_PRIVATE_KEY!,

baseUrl: "https://api.warppay402.com"

});

async function run() {

// Consultar análisis de cartera Base ($0.002 USDC)

const analytics = await client.execute("base_analytics", {

address: "0x556c77792642E8ff95eC930FFb8D46a76579126E"

});

console.log("Saldo ETH Base:", analytics.ethBalance);

console.log("Nonce de cuenta:", analytics.nonce);

}

run();

Integración con MCP y Claude

Conecte las herramientas de WarpPay402 directamente a Claude Desktop, Cursor o Glama AI utilizando el Protocolo de Contexto de Modelo (MCP).

Añada el siguiente bloque a su claude_desktop_config.json:

{

"mcpServers": {

"warppay402": {

"command": "npx",

"args": [

"-y",

"@warppay402/mcp-server",

"--gateway",

"https://api.warppay402.com/mcp?v=2"

]

}

}

}

Referencia completa de la API (21 herramientas)

-public_data_feed

Método y ruta: GET /public_data_feed/:file

Precio (USDC): $0.0001

Descripción: Obtiene registros JSON de atestación pública firmados.

-data_feeds

Método y ruta: GET /api/v1/feeds/:feedId

Precio (USDC): $0.0010

Descripción: Fuentes de inteligencia de mercado y rendimientos pre-extraídas.

-web_scraper

Método y ruta: POST /api/v1/tools/web-scraper

Precio (USDC): $0.0010

Descripción: Convierte páginas web públicas en Markdown limpio para contextos de LLM.

-browser_scraper

Método y ruta: POST /api/v1/tools/browser-scraper

Precio (USDC): $0.0050

Descripción: Scraper Chromium sin interfaz gráfica respaldado por trabajadores de proxy residencial.

-base_analytics

Método y ruta: POST /api/v1/tools/base-analytics

Precio (USDC): $0.0020

Descripción: Devuelve saldo ETH, nonce de transacción y detalles de cartera en Base.

-arc_analytics

Método y ruta: POST /api/v1/tools/arc-analytics

Precio (USDC): $0.0010

Descripción: Obtiene altura de bloque en vivo, precios de gas y estado de RPC en Arc Mainnet.

-arc_network_oracle_query

Método y ruta: POST /api/v1/tools/arc-network-query

Precio (USDC): $0.1000

Descripción: Telemetría Arc previa al vuelo: latencia RPC (ms), tendencias de gas y saldo.

-arc_dex_oracle

Método y ruta: POST /api/v1/tools/arc-dex-oracle

Precio (USDC): $0.0010

Descripción: Resolvedor de precio spot ETH/USDC en tiempo real para pools de Arc Mainnet.

-pdf_extractor

Método y ruta: POST /api/v1/tools/pdf-extractor

Precio (USDC): $0.0050

Descripción: Descarga y analiza documentos PDF públicos en texto plano.

-render_screenshot

Método y ruta: POST /api/v1/tools/render-screenshot

Precio (USDC): $0.0100

Descripción: Captura datos de imagen de captura de pantalla renderizada de página completa.

-extract_json

Método y ruta: POST /api/v1/tools/extract-json

Precio (USDC): $0.0100

Descripción: Extrae datos de esquema JSON estructurado de páginas web HTML.

-smart_contract_verifier

Método y ruta: POST /api/v1/tools/smart-contract-verifier

Precio (USDC): $0.0200

Descripción: Análisis de código fuente Basescan, validación de bytecode y obtención de ABI.

-get_aerodrome_yields

Método y ruta: GET /api/v1/tools/aerodrome-yields

Precio (USDC): $0.0030

Descripción: Oportunidades de rendimiento DEX de Aerodrome en tiempo real, APY de pools y TVL.

-aerodrome_swap

Método y ruta: POST /api/v1/tools/aerodrome-swap

Precio (USDC): $0.0100

Descripción: Intercambios de tokens programáticos ejecutados a través del Router de Aerodrome Finance.

-aerodrome_clamm

Método y ruta: POST /api/v1/tools/aerodrome-clamm

Precio (USDC): $0.0100

Descripción: Gestión de posiciones de liquidez concentrada (Slipstream).

-aerodrome_veaero

Método y ruta: POST /api/v1/tools/aerodrome-veaero

Precio (USDC): $0.0100

Descripción: Automatiza el bloqueo de $AERO, votación de gauges de época y recolección de sobornos.

-deploy_contract

Método y ruta: POST /api/v1/tools/deploy-contract

Precio (USDC): $5.0000

Descripción: Despliega contratos personalizados de Custodia, Recompensa o Agente en Base.

-deploy_solana_contract

Método y ruta: POST /api/v1/tools/deploy-solana-contract

Precio (USDC): $5.0000

Descripción: Inicializa programáticamente Custodias SPL o Bóvedas Raydium en Solana.

-deploy_arc_contract

Método y ruta: POST /api/v1/tools/deploy-arc-contract

Precio (USDC): $5.0000

Descripción: Despliega contratos de Custodia, Recompensa o Agente directamente en Arc Mainnet.

-arc_cctp_bridge

Método y ruta: POST /api/v1/tools/arc-cctp-bridge

Precio (USDC): $0.2500

Descripción: Transferencias USDC entre cadenas desde Arc Mainnet a través de Circle CCTP V2.

-x402_telemetry_feed

Método y ruta: GET /api/v1/telemetry/settlements

Precio (USDC): Gratis

Descripción: Telemetría pública de liquidaciones, endpoints activos y pruebas en cadena.

Paymaster sin gas (ERC-4337 / ERC-7677 v0.8)

WarpPay402 aloja un Paymaster v0.8 integrado en Base Mainnet. Las Cuentas Inteligentes que poseen USDC pueden ejecutar paquetes de transacciones sin gas utilizando facturación con margen en USDC.

Endpoint RPC del Paymaster: [https://api.warppay402.com/api/v1/paymaster/rpc\](https://api.warppay402.com/api/v1/paymaster/rpc)

Endpoint de cotización: [https://api.warppay402.com/api/v1/paymaster/quote\](https://api.warppay402.com/api/v1/paymaster/quote)

Soporte y contacto empresarial

Para asistencia técnica, límites de tasa más altos, nodos de proxy dedicados o integraciones de herramientas personalizadas:

Correo electrónico: [email protected]

Endpoints de descubrimiento para servidores MCP y agentes de IA

Conecte WarpPay402 directamente a Claude Desktop, Cursor, Glama AI o tiempos de ejecución de agentes de IA personalizados utilizando nuestros manifiestos de descubrimiento públicos.

Endpoint del Protocolo de Contexto de Modelo (MCP):

https://api.warppay402.com/mcp?v=2

Manifiesto de contexto para agentes de IA / LLM (llms.txt):

https://api.warppay402.com/llms.txt

Manifiesto de descubrimiento de agentes x402:

https://api.warppay402.com/.well-known/x402-manifest.json

Manifiesto del conector MCP:

https://api.warppay402.com/.well-known/mcp.json

Página actualizada

Google Sites

Reportar abuso