# URLGate Premium Membership Purchase

> URLGate Premium Membership Purchase is a paid API for AI agents from urlgate.xyz, paid per call via x402, $5/call, status unknown (last checked 2026-10-22).

Purchases a 31-day premium membership on URLGate by paying 5 USDC via x402, crediting the membership to the paying or signed-in wallet.

## Facts

- Endpoint: GET https://urlgate.xyz/api/v2/membership/purchase?utm_source=zero.xyz
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/urlgate-premium-membership-purchase-64479e5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__siAqx6mvZ0cj5mMfNeCG

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-premium-membership-purchase-64479e5b
```

Example prompt: Purchase a URLGate premium membership for my wallet right now — pay the 5 USDC fee using my x402 payment signature and activate the 31-day premium period.

## When to prefer this

Use this endpoint when an agent or user wants to activate or renew URLGate premium membership by paying 5 USDC via the x402 protocol. It is the direct purchase path — prefer it over any free-tier flows or link-creation endpoints when the goal is specifically to upgrade wallet access. Best suited for AI agents operating autonomously with x402 payment capabilities on Base.

## Known failure modes

- Payment signature missing or invalid — 402 response requiring payment
- Insufficient USDC balance in wallet — payment rejected
- Wallet address not resolvable from auth headers — membership cannot be credited
- Network congestion causing slow settlement — timeout before confirmation
- Already active membership — may result in extension or no-op depending on state

## 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 confirming success, the wallet credited, the network the payment settled on (e.g. eip155:8453 for Base), the amount paid, the membership object (tier, state, active status, daysLeft, periodStart, periodEnd, renewalDue), a transaction hash, and a receipt with ID and URL for verification.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "description": "No fields needed (an empty object or no body). Pay with the PAYMENT-SIGNATURE header. Premium is credited to the signed-in wallet (Bearer / SIGN-IN-WITH-X), else to the paying wallet."
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "wallet",
      "membership",
      "network",
      "amount",
      "receipt"
     ],
     "properties": {
      "amount": {
       "type": "string",
       "description": "USDC paid"
      },
      "wallet": {
       "type": "string",
       "description": "Wallet the Premium period was credited to"
      },
      "message": {
       "type": "string"
      },
      "network": {
       "type": "string",
       "description": "CAIP-2 id the payment settled on"
      },
      "receipt": {
       "type": "object",
       "properties": {
        "id": {
         "type": "string"
        },
        "url": {
         "type": "string",
         "format": "uri"
        }
       }
      },
      "success": {
       "type": "boolean"
      },
      "membership": {
       "type": "object",
       "properties": {
        "tier": {
         "enum": [
          "free",
          "premium"
         ],
         "type": "string"
        },
        "state": {
         "enum": [
          "active",
          "renewal_due",
          "expired",
          "revoked",
          "none"
         ],
         "type": "string"
        },
        "active": {
         "type": "boolean"
        },
        "source": {
         "type": [
          "string",
          "null"
         ]
        },
        "daysLeft": {
         "type": "integer"
        },
        "periodEnd": {
         "type": "string",
         "format": "date-time"
        },
        "renewalDue": {
         "type": "boolean"
        },
        "periodStart": {
         "type": "string",
         "format": "date-time"
        }
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "amount": "5",
  "wallet": "0x1111111111111111111111111111111111111111",
  "message": "Premium active until 2026-02-01T00:00:00.000Z. Nothing renews automatically.",
  "network": "eip155:8453",
  "receipt": {
   "id": "r_example",
   "url": "https://urlgate.xyz/r/r_example"
  },
  "success": true,
  "membership": {
   "tier": "premium",
   "state": "active",
   "active": true,
   "source": "x402",
   "daysLeft": 31,
   "periodEnd": "2026-02-01T00:00:00.000Z",
   "renewalDue": false,
   "periodStart": "2026-01-01T00:00:00.000Z",
   "reminderDismissed": false
  },
  "transaction": "0xabababababababababababababababababababababababababababababababab"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/urlgate-premium-membership-purchase-64479e5b/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)
