---
title: "Paywall a link with just a wallet"
description: "Urlgate setup skips the password and the storefront. Sign in with your wallet, paste a URL, set a USDC price, and share a pay-per-link shortlink that people and AI agents unlock over x402."
date: 2026-11-18
published: 2026-11-18T08:30:00-08:00
canonical: https://urlgate.xyz/news/paywall-a-link-with-just-a-wallet
image: https://urlgate.xyz/news/images/2026-11-18-og.jpg
---

# Paywall a link with just a wallet

November 18, 2026 · https://urlgate.xyz/news/paywall-a-link-with-just-a-wallet

Most ways to sell access to a file or page start with paperwork: create an account, pick a password, set up a store, wire up a checkout. Urlgate starts with the wallet you already have.

## Four steps

1. **Wallet.** Sign in to [urlgate.xyz](https://urlgate.xyz) by signing a message with your wallet (Sign-In With Ethereum). There is no password to create or reset.
2. **Link.** Paste the URL you want to paywall: a PDF, a private page, a download, or an API endpoint.
3. **Price.** Set a USDC price. New links start at 0.01 USDC by default.
4. **Share.** Post the shortlink anywhere you already share links.

That is the whole setup.

## What buyers see

A person who opens the shortlink sees a paywall card, pays in USDC, and goes straight to your destination. An AI agent that requests the same link gets an HTTP 402 response with the price, pays over x402, and gets the same access. You do not issue API keys or manage a customer list for either one.

## Agents can sign in too

Wallet sign-in works for software as well as people. An agent can sign in with its own wallet and use a revocable session token, so a script or agent can manage its paid links, such as changing a price or pausing a link, without a browser.

## Start small

Pick one link people already ask you for and put a low price on it. You can change the price later, and every creator who gates links shows up on the public leaderboard for future rewards.

[Paywall your first link at urlgate.xyz](https://urlgate.xyz)

## For agents

Machine-readable summary for AI agents and their builders. Always trust the live 402 challenge and `GET https://urlgate.xyz/api/v2/config` over any number on this page.

- What: pay-to-open short links. `GET https://urlgate.xyz/{code}` (or `GET https://urlgate.xyz/api/urlgate/{code}`) with `Accept: application/json` answers `402 Payment Required`; pay in USDC, then retry the same request.
- Challenge: the x402 v2 `PaymentRequired`, base64, in the `PAYMENT-REQUIRED` header. A legacy x402 v1 JSON body is also sent; pay from the header.
- Networks on this host: Base (`eip155:8453`), Polygon (`eip155:137`), Arbitrum (`eip155:42161`). USDC only. The code supports Base, Base Sepolia, Polygon, Arbitrum; admins can disable networks, so read `accepts[]`, `https://urlgate.xyz/.well-known/x402` or `/api/v2/config`.
- Paid opens need TWO signatures in ONE retry, same wallet, same network: `PAYMENT-SIGNATURE` (an `accepts[]` entry: the creator's share) and `PAYMENT-SIGNATURE-FEE` (the `extensions["platform-fee"].accepts[]` entry: the 0.3% platform fee to URLGate), each a base64 x402 v2 `PaymentPayload` (EIP-3009, no gas). Without the fee leg: `402` with code `fee_leg_missing`, nothing charged.
- Settlement: URLGate verifies and settles the payment itself (native settlement, no facilitator). The result is in the `PAYMENT-RESPONSE` header; the JSON `200` body has `destination` and `receiptUrl`.
- Already paid: send `SIGN-IN-WITH-X` or a Bearer token for the buying wallet. No second charge.
- MCP: `open_link` on `https://urlgate.xyz/mcp` with `_meta["x402/payment"]` + `_meta["x402/payment-fee"]`.
- Create links: the website form is free. API / MCP (`POST https://urlgate.xyz/api/urlgate/agent/create`, tool `create_link`): free within the daily quota when signed in (Bearer / SIGN-IN-WITH-X) or with an agent key (Bearer `ugk_…`); anonymous or over quota, the 0.01 USDC creation fee via x402 (one signature, no fee leg).
- Minimum price for new links on this host: 0.01 USDC (up to 6 decimals).
- Test your client first: `POST https://urlgate.xyz/api/v2/payments/compat-check` (free, verify-only, never settled).
- Read next: [llms.txt](https://urlgate.xyz/llms.txt), [SKILL.md](https://urlgate.xyz/skills/urlgate/SKILL.md), [/agents](https://urlgate.xyz/agents) ([JSON](https://urlgate.xyz/agents?format=json)), [get-started](https://urlgate.xyz/api/v2/agents/get-started), [/.well-known/x402](https://urlgate.xyz/.well-known/x402), [OpenAPI](https://urlgate.xyz/openapi.json).

Example (a 0.05 USDC link at 0.3%: 49850 units to the creator, 150 units to URLGate):

```
GET https://urlgate.xyz/Gp1qJx
Accept: application/json

402 Payment Required
PAYMENT-REQUIRED: base64({ x402Version: 2,
  accepts: [{ scheme: "exact", network: "eip155:8453", amount: "49850", payTo: "0xCreator…", … }],
  extensions: { "platform-fee": { accepts: [{ scheme: "exact", network: "eip155:8453", amount: "150", payTo: "0xURLGate…", … }] } } })

GET https://urlgate.xyz/Gp1qJx
Accept: application/json
PAYMENT-SIGNATURE: base64(PaymentPayload for accepts[0])
PAYMENT-SIGNATURE-FEE: base64(PaymentPayload for extensions["platform-fee"].accepts[0])

200 OK
PAYMENT-RESPONSE: base64(settlement)
{ "destination": "https://…", "receiptUrl": "…" }
```

## FAQ

### What is URLGate?

A pay-to-open URL shortener: any URL becomes a short link that people and AI agents unlock by paying USDC over x402.

### What does HTTP 402 mean?

HTTP 402 is Payment Required. x402 uses it: the server answers 402 with a price, the client pays in USDC and retries the same request.

### How does an AI agent pay to open a URLGate link?

Request the link with Accept: application/json and read the x402 v2 challenge in the PAYMENT-REQUIRED header. Sign two USDC authorizations with the same wallet on the same network (PAYMENT-SIGNATURE for the creator, PAYMENT-SIGNATURE-FEE for the 0.3% platform fee) and send both in one retry. URLGate verifies and settles the payment itself; there is no facilitator. A wallet that already paid gets back in with SIGN-IN-WITH-X or a Bearer token, without paying again.

### What is the minimum price for a new link?

0.01 USDC on this host (the default is 0.01 USDC). The live value is in GET https://urlgate.xyz/api/v2/config.

### Which networks does URLGate accept?

USDC on Base (eip155:8453), Polygon (eip155:137), Arbitrum (eip155:42161) on this host. The code supports Base, Base Sepolia, Polygon, Arbitrum. Read accepts[] in the 402, /.well-known/x402 or /api/v2/config for the current list.

### Does it cost anything to create a link?

The website create form is free. Over the API or MCP, creating links is free within a daily quota when signed in or with an agent key; otherwise the 0.01 USDC creation fee is charged via x402.
