# URLGate Create Pay-to-Open Link

> URLGate Create Pay-to-Open Link is a paid API for AI agents from urlgate.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-22).

Wraps any destination URL in a USDC paywall, returning a short link that only reveals the content after payment

## Facts

- Endpoint: POST https://urlgate.xyz/api/urlgate/create?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/urlgate-create-pay-to-open-link-7b3bfa79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MgzZnw-ZU2LEPO8w6iZa5

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 urlgate-create-pay-to-open-link-7b3bfa79 -d '<json body>'
```

Example prompt: Create a URLGate pay-to-open link for https://mydomain.com/exclusive-report that charges 0.05 USDC per open, title it 'Q1 Market Report', and redirect the buyer straight to the page after they pay.

## When to prefer this

Choose this endpoint when you need to monetize access to any URL with per-open USDC micropayments, especially when AI agents are either the creators or expected consumers of the link. It is the right choice over generic URL shorteners when payment gating is required, and over custom smart-contract paywalls when you need instant setup, a hosted short URL, and built-in x402 v2 agent-payment compatibility with automatic fee splitting.

## Known failure modes

- 400 networks_required — networks array was provided but empty
- 400 network_unavailable — one or more CAIP-2 IDs are disabled or unrecognized
- 403 — wallet address supplied does not match the authenticated wallet or agent key owner
- 402 — creation fee of $0.01 USDC not paid or payment failed
- 422 — price below minimum 0.01 USDC or more than 6 decimal places
- 409 — requested shortcode already taken
- 400 — destination URL is not a valid http/https URI
- 400 — title exceeds 120 characters or description exceeds 500 characters

## How this service works

Turn any URL into a link that charges USDC to open. Built on x402 v2, so AI agents can pay as easily as people.

## Output

Returns a JSON object with the shortened pay-to-open URL, unique shortcode, creation timestamp, destination URL, USDC price, fee breakdown showing the 99.7% creator share and 0.3% platform fee, payout wallet address, and a flag indicating whether the link was created by an agent.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri",
   "description": "Destination (http / https) revealed after payment"
  },
  "price": {
   "type": "string",
   "description": "USDC, e.g. \"0.05\". Minimum 0.01, max 6 decimals"
  },
  "title": {
   "type": "string",
   "maxLength": 120
  },
  "wallet": {
   "type": "string",
   "description": "Payout wallet (receives 99.7% of opens (0.3% platform fee)). Optional: defaults to the signed-in wallet (or the agent key owner), else the wallet paying the creation fee; any other address is refused (403)"
  },
  "afterPay": {
   "enum": [
    "receipt",
    "redirect"
   ],
   "type": "string"
  },
  "networks": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "minItems": 1,
   "description": "CAIP-2 ids to sell on: at least one, all from GET /api/v2/networks. Omit for every enabled network. [] → 400 networks_required; a disabled or unknown id → 400 network_unavailable"
  },
  "shortcode": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{3,20}$"
  },
  "description": {
   "type": "string",
   "maxLength": 500
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "price": "0.050000",
  "title": "Example article",
  "success": true,
  "shortUrl": "https://urlgate.xyz/Gp1qJx",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "shortcode": "Gp1qJx",
  "agentCreated": true,
  "creationMode": "paid",
  "feeBreakdown": {
   "appliesTo": "each paid open",
   "buyerPays": "0.050000",
   "serviceFee": "0.000150",
   "creatorReceives": "0.049850",
   "creatorPercentage": 99.7,
   "serviceFeePercentage": 0.3
  },
  "creatorWallet": "0x1111111111111111111111111111111111111111",
  "destinationUrl": "https://example.com/article"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/urlgate-create-pay-to-open-link-7b3bfa79/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from urlgate.xyz](https://www.zero.xyz/host/urlgate.xyz/llms.txt)