cross-dex-arbitrage-alert

Detect cross-DEX token price spreads across Ethereum and Base

2 Entrypoints
v0.1.0 Version
Enabled Payments

crossdex-arbitrage-alert.vercel.app

Entrypoints

Explore the capabilities exposed by this agent. Invoke with JSON, stream responses when available, and inspect pricing where monetization applies.

scan

Invoke

Scan multiple DEXs for profitable arbitrage routes

Pricing Invoke: 0.02

Network base

Invoke Endpoint POST /entrypoints/scan/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "token_in": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$"
    },
    "token_out": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$"
    },
    "amount_in": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "chains": {
      "default": [
        "ethereum",
        "base",
        "bsc"
      ],
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "token_in",
    "token_out",
    "amount_in",
    "chains"
  ],
  "additionalProperties": false
}

Output Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "best_route": {
      "type": "string"
    },
    "alt_routes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "net_spread_bps": {
      "type": "number"
    },
    "est_fill_cost": {
      "type": "number"
    },
    "timestamp": {
      "type": "string"
    }
  },
  "required": [
    "best_route",
    "alt_routes",
    "net_spread_bps",
    "est_fill_cost",
    "timestamp"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://crossdex-arbitrage-alert.vercel.app/entrypoints/scan/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "token_in": "string",
        "token_out": "string",
        "amount_in": 0,
        "chains": [
          "string"
        ]
      }
    }
  '

status

Invoke

Check agent health and supported chains/DEXs

Pricing Invoke: 0.02

Network base

Invoke Endpoint POST /entrypoints/status/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Output Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "status": {
      "type": "string"
    },
    "supported_chains": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "supported_dexs": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "supported_tokens": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "status",
    "supported_chains",
    "supported_dexs",
    "supported_tokens"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://crossdex-arbitrage-alert.vercel.app/entrypoints/status/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {}
    }
  '

Client Example: x402-fetch

Use the x402-fetch helpers to wrap a standard fetch call and automatically attach payments. This script loads configuration from .env, pays the facilitator, and logs both the response body and the decoded payment receipt.

import { config } from "dotenv";
import {
  decodeXPaymentResponse,
  wrapFetchWithPayment,
  createSigner,
  type Hex,
} from "x402-fetch";

config();

const privateKey = process.env.PRIVATE_KEY as Hex | string;
const baseURL = process.env.RESOURCE_SERVER_URL as string; // e.g. https://example.com
const endpointPath = process.env.ENDPOINT_PATH as string; // e.g. /weather
const url = `${baseURL}${endpointPath}`; // e.g. https://example.com/weather

if (!baseURL || !privateKey || !endpointPath) {
  console.error("Missing required environment variables");
  process.exit(1);
}

/**
 * Demonstrates paying for a protected resource using x402-fetch.
 *
 * Required environment variables:
 * - PRIVATE_KEY            Signer private key
 * - RESOURCE_SERVER_URL    Base URL of the agent
 * - ENDPOINT_PATH          Endpoint path (e.g. /entrypoints/echo/invoke)
 */
async function main(): Promise<void> {
  // const signer = await createSigner("solana-devnet", privateKey); // uncomment for Solana
  const signer = await createSigner("base-sepolia", privateKey);
  const fetchWithPayment = wrapFetchWithPayment(fetch, signer);

  const response = await fetchWithPayment(url, { method: "GET" });
  const body = await response.json();
  console.log(body);

  const paymentResponse = decodeXPaymentResponse(
    response.headers.get("x-payment-response")!
  );
  console.log(paymentResponse);
}

main().catch((error) => {
  console.error(error?.response?.data?.error ?? error);
  process.exit(1);
});

Manifest

Loading…

Fetching agent card…