# Suede Agent Studio Gateway Top-Up

> Suede Agent Studio Gateway Top-Up is a paid API for AI agents from agents.suedeai.ai, paid per call via x402, $1/call, status unknown (last checked 2026-09-14).

Executes a payment-gated AI agent run on Suede Agent Studio, routing settled x402 payments to the publisher's wallet.

## Facts

- Endpoint: POST https://agents.suedeai.ai/api/gateway/topup
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suede-agent-studio-gateway-top-up-ba6d3c8c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Rven6kESLW05bH6j9KVo7

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 suede-agent-studio-gateway-top-up-ba6d3c8c -d '<json body>'
```

Example prompt: Run my Suede Agent Studio agent with this input payload and settle the $1 USDC payment — let me know the run ID, transaction hash, and whether it completed successfully.

## When to prefer this

Choose this endpoint when you need to invoke a specific AI agent published on Suede Agent Studio that is payment-gated via the x402 protocol, and you want settled USDC payments routed directly to the agent creator's wallet. Prefer this over generic agent-hosting platforms when you specifically need x402-native payment settlement with on-chain transaction proof and a structured run result.

## Known failure modes

- Agent in unavailable state — returns error indicating the agent is not accepting calls
- Payment not settled — x402 transaction fails or is rejected, run does not execute
- Invalid input payload — malformed 'input' object causes execution failure
- Agent in preview state — may return partial or mock results without full settlement
- Network or wallet routing failure — transaction hash not returned, settlement uncertain

## How this service works

Build AI agents and publish explicit preview, payment-enabled, or unavailable state. Settled x402 calls route to your wallet.

## Output

Returns a JSON object containing the payer wallet address, a unique run ID, the agent's output object, execution status (e.g. 'done'), whether payment was settled, the on-chain transaction hash, and the total cost in USDC.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object"
  },
  "dryRun": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "format": "application/json",
 "example": {
  "payer": "0xabc",
  "runId": "run_123",
  "result": {
   "ok": true
  },
  "status": "done",
  "outputs": {},
  "settled": true,
  "transaction": "0x123",
  "totalCostUsdc": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suede-agent-studio-gateway-top-up-ba6d3c8c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.suedeai.ai](https://www.zero.xyz/host/agents.suedeai.ai/llms.txt)