---
title: "Fetch x402 pricing and payment configuration"
method: GET
path: "/billing/x402/config"
tags: ["Discover"]
---

# Fetch x402 pricing and payment configuration

`GET /billing/x402/config`

## Request

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

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.

## Response `200`

x402 payment configuration

- object
  - `enabled` boolean, required: Whether x402 pay-per-request is active on this server.
  - `network` string, required: Blockchain network where payments are accepted.
  - `asset` string, required: USDC contract address on the configured network.
  - `payTo` string, nullable, required: EVM wallet address that receives payments (null when disabled).
  - `paymentOptions` object[], required: Canonical list of payment methods that can satisfy a live 402 challenge. Base is listed first when x402 is enabled. Solana is listed only when its recipient wallet is configured, as an additional option rather than a replacement for Base.
    - `network` string, required: CAIP-2 network identifier, matching a 402 `accepts[].network` value.
    - `asset` string, required: USDC token contract or mint address on `network`.
    - `payTo` string, required: Recipient wallet address on `network`, matching a 402 `accepts[].payTo` value.
    - `header` 'X-PAYMENT' | 'PAYMENT-SIGNATURE', required: Required request header containing the signed x402 payment payload.
    - `feePayer` string: Solana-only PayAI wallet that sponsors the transaction fee; absent for Base.
  - `solana` object, nullable: Legacy optional Solana payment details. Prefer `paymentOptions` for new integrations.
    - `network` string, required
    - `asset` string, required
    - `payTo` string, required
  - `facilitatorUrl` string, required: Base URL of the x402 facilitator used to verify payments.
  - `creditsPerUsdc` integer, required: How many platform credits equal 1 USDC (determines price per credit).
  - `callPrices` object, required: Per-call-type price table.
  - `simulationRetentionDays` integer: 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.
  - `autoClaimOnFirstStep` boolean: 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.

## Other responses

- `500`: Internal server error

---

[API](https://skmtc.dev/cloudworldmodel/apis/cloud-world-model-agent-api.md) · [All operations](https://skmtc.dev/cloudworldmodel/apis/cloud-world-model-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudworldmodel/apis/cloud-world-model-agent-api/revisions/ecc3ad1ff07f?raw)