Discover

Fetch x402 pricing and payment configuration

Returns the x402 payment configuration for this server, including canonical paymentOptions, the legacy Base-primary fields, facilitator URL, and per-call-type price table. Base USDC is the primary option. Solana USDC-SPL is an additional option only when it appears in paymentOptions; it does not replace the Base option.

AI agents can use this endpoint to discover whether x402 anonymous pay-per-request is enabled, choose an advertised network, and obtain the exact USDC amounts required before sending the option's required payment header (X-PAYMENT for Base or PAYMENT-SIGNATURE for optional Solana) to a metered endpoint.

This endpoint requires no authentication and is always public.

get/billing/x402/config

Request

  • Base URL: https://www.cloudworldmodel.ai/api
  • URL: https://www.cloudworldmodel.ai/api/billing/x402/config
  • Auth: none required

Response

x402 payment configuration

enabledboolean required

Whether x402 pay-per-request is active on this server.

networkstring required

Blockchain network where payments are accepted.

assetstring required

USDC contract address on the configured network.

payTostring nullable required

EVM wallet address that receives payments (null when disabled).

facilitatorUrlstring required

Base URL of the x402 facilitator used to verify payments.

creditsPerUsdcinteger required

How many platform credits equal 1 USDC (determines price per credit).

callPricesobject required

Per-call-type price table.

simulationRetentionDaysinteger

Number of days an x402-wallet-owned simulation is retained after its last activity (step, update). Every /step-hybrid call on a simulation resets this rolling window. After the window expires, the simulation and all its metrics are permanently deleted by the server's cleanup sweep.

autoClaimOnFirstStepboolean

When true, an unclaimed (demo) simulation is automatically assigned to the paying wallet's ownership on its first x402-authenticated /step-hybrid call. No explicit claim endpoint is required.

Example response

{
  "enabled": true,
  "network": "base",
  "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "payTo": "0xYourWalletAddress",
  "paymentOptions": [
    {
      "network": "eip155:8453",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0xYourWalletAddress",
      "header": "X-PAYMENT"
    },
    {
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "payTo": "YourSolanaWalletAddress",
      "header": "PAYMENT-SIGNATURE",
      "feePayer": "2wKupLR9q6wXYppw8Gr2NvWxKBUqm4PPJKkQfoxHDBg4"
    }
  ],
  "solana": {
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "payTo": "YourSolanaWalletAddress"
  },
  "facilitatorUrl": "https://facilitator.payai.network",
  "creditsPerUsdc": 1000,
  "callPrices": {
    "chaos.run": {
      "credits": 5,
      "usdcAtomicUnits": "5000",
      "usdcDisplay": "$0.0050"
    },
    "rl.step": {
      "credits": 3,
      "usdcAtomicUnits": "3000",
      "usdcDisplay": "$0.0030"
    }
  },
  "simulationRetentionDays": 90,
  "autoClaimOnFirstStep": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.