Skip to main content

​
Overview

The /supported endpoint returns a list of blockchain networks that the OpenX402 facilitator currently supports. Use this to check network availability before processing payments.

​
Endpoint

GET https://open.x402.host/supported

​
Request

No parameters required. This is a public endpoint that doesn’t require authentication.

​
Example Request

curl https://open.x402.host/supported

​
Response

Returns a JSON object containing supported networks and facilitator information.

​
Response Schema

FieldTypeDescription
networksarrayList of supported blockchain networks
facilitatorstringFacilitator identifier
versionstringAPI version

​
Example Response

{
  "networks": ["base", "xlayer"],
  "facilitator": "openx402",
  "version": "1.0"
}

​
Supported Networks

NetworkStatusDescription
base✅ ProductionEthereum L2, primary facilitator
xlayer✅ MainnetOKX Layer-2 solution
solana🔄 Coming SoonHigh-speed blockchain

​
Usage Example

Check network availability before processing a payment: 
async function isNetworkSupported(network) {
  const response = await fetch('https://open.x402.host/supported');
  const data = await response.json();
  return data.networks.includes(network);
}

// Usage
if (await isNetworkSupported('base')) {
  // Proceed with Base payment
} else {
  // Handle unsupported network
}

​
Error Handling

This endpoint should always return successfully. If it fails, the facilitator may be experiencing downtime. 
try {
  const response = await fetch('https://open.x402.host/supported', {
    timeout: 5000 // 5 second timeout
  });

  if (!response.ok) {
    throw new Error('Facilitator unavailable');
  }

  const data = await response.json();
} catch (error) {
  console.error('Failed to check supported networks:', error);
  // Fallback to default networks or show error
}

​
Rate Limiting

This endpoint is not rate limited as it’s used for discovery and health checking.