# x402 Agent Suite Pro – Settlement Graph Next Step

> x402 Agent Suite Pro – Settlement Graph Next Step is a paid API for AI agents from x402-agent-suite-production.up.railway.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-22).

Returns the next allowed action in an x402 payment settlement graph for a given HTTP method type, indicating whether the action is permitted after payment settlement.

## Facts

- Endpoint: POST https://x402-agent-suite-production.up.railway.app/api/settlement-graph/next?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-agent-suite-pro-settlement-graph-next-step-0f3ebf97
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sBl0hiQJTphGfozQIpiWo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-agent-suite-pro-settlement-graph-next-step-0f3ebf97 -d '<json body>'
```

Example prompt: Check what the next allowed step is in the x402 settlement graph for a GET request — I need to know if the action is permitted after payment and get a summary of the settlement state.

## When to prefer this

Choose this endpoint when your AI agent pipeline needs to determine the next permitted action in an x402 payment settlement graph specifically for GET, HEAD, or DELETE HTTP methods. Prefer this over generic authorization checks when your architecture is built around the x402 protocol and you need structured pipeline orchestration with settlement-aware routing.

## Known failure modes

- Missing required 'input' object returns 400 validation error
- Invalid or unsupported HTTP method (e.g. POST or PUT) rejected by enum constraint
- x402 payment not settled or payment header missing causes 402 Payment Required response
- Malformed input schema causes JSON parse error
- Service unavailability on Railway deployment returns 5xx

## How this service works

24 paid x402 infrastructure APIs for AI agent fleets: buy advisor, audition coach, guard, proxy, MPP, attestations, and pipeline orchestration.

## Output

Returns a JSON object with three fields: 'ok' (boolean indicating the request succeeded), 'allowed' (boolean indicating whether the requested HTTP action is permitted following x402 settlement), and 'summary' (a human-readable string describing the settlement outcome and authorization status).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "ok",
      "allowed",
      "summary"
     ],
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "allowed": {
       "type": "boolean"
      },
      "summary": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "allowed": true,
  "summary": "Paid response after x402 settlement"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-agent-suite-pro-settlement-graph-next-step-0f3ebf97/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-suite-production.up.railway.app](https://www.zero.xyz/host/x402-agent-suite-production.up.railway.app/llms.txt)