Upload and sell a hosted file on Loomal no server required.
Drop a dataset, PDF, or model file into the console, set a per-call USDC price, and Loomal serves it at a paywalled URL. Buyers — human or agent — pay via x402 and download.
Most x402 guides assume you run an API. You don't need one to sell on Loomal. A hosted endpoint is a file or JSON blob that Loomal stores and serves for you at a URL like loomal.ai/h/your-slug — with the x402 paywall already in front of it.
That makes it the fastest path from 'I have something worth paying for' to 'agents are paying for it': a curated dataset, a research PDF, a fine-tuned model's weights, a license file. This guide walks through the upload, the pricing, and what the buyer actually experiences.
What a hosted endpoint is
In the Loomal console, endpoints come in two modes. Proxied endpoints sit in front of a URL you run. Hosted endpoints have no upstream at all: you paste JSON or upload a file, and Loomal serves the response itself after payment settles.
For files, the upload is stored in S3 and never exposed directly. When a buyer pays, Loomal responds with a 302 redirect to a signed download URL that expires after five minutes. Nobody gets a permanent link to share around — every download is a paid call.
Step 1: Upload the file
In the console, open your identity, go to Endpoints, and click 'Add hosted endpoint'. Choose a slug — lowercase letters, digits, and hyphens, between 3 and 60 characters. The slug becomes your public URL: loomal.ai/h/county-parcels-2025, for example. Pick it like a product name, because it is one.
Then upload the file. PDF, CSV, ZIP, images, and similar formats are accepted, up to 10 MB per file. Set a filename so buyers get a sensible download, and add a title and description — these are what surface in discovery, so say what the file contains and why it's worth the price.
Step 2: Price it
Set the price in USDC per download. The minimum is $0.01; the console defaults to $0.05. There is no tier system to design and no checkout page to build — one number, charged on every successful call.
You can reprice at any time from the same form, and the new price takes effect on the next call. Loomal's fee is 5% on settled transactions, currently waived. A practical starting point: price a one-off document like the value of the hour it saves, and price a dataset agents will fetch repeatedly low enough that re-fetching beats scraping.
What the buyer sees
Anyone — or any agent — hitting your URL without payment gets an HTTP 402 challenge describing the price and where to pay. An x402-capable client signs a USDC authorization, retries the request, settlement clears on Base in about two seconds, and the response is the redirect to the signed download URL. Every settled call comes with an Ed25519-signed receipt.
$ curl -i https://loomal.ai/h/county-parcels-2025
HTTP/1.1 402 Payment Required
{
"x402Version": 1,
"accepts": [{
"scheme": "exact",
"network": "base",
"maxAmountRequired": "50000",
"payTo": "0xYourWallet…",
"description": "County parcel dataset, 2025 (CSV)"
}]
}
# An x402 client pays and retries → 302 to a signed S3 URL
# that expires in 5 minutes. One payment, one download window.Updating and retiring the listing
Replacing the file or editing the price keeps the same slug and URL, so links in agent configs and documentation keep working. If you delete the endpoint, the slug is retired permanently — Loomal soft-deletes it and reserves the name forever, so a third party can never register your old URL and serve something else under it.
Track downloads and revenue from the console; each endpoint shows its call count and settled USDC total. When the file outgrows a flat price — say agents only want one slice of a large dataset — that's the cue to graduate to a real API endpoint with per-query pricing.
FAQ
What file types and sizes can I sell?
PDF, CSV, ZIP, images, and similar formats, up to 10 MB per file. Larger assets are better served from your own storage behind a proxied or forward endpoint, where Loomal still handles the x402 paywall but you control the bytes.
Can a buyer share the download link after paying?
Not usefully. Payment returns a signed URL that expires after five minutes, so the link dies shortly after the download. Each new download requires a new paid call.
Do I need to write any code?
No. The entire flow — upload, slug, price — happens in the Loomal console. The x402 handshake, settlement on Base, and signed receipts are handled by Loomal's infrastructure in front of your file.
What does it cost to list?
There's no listing fee. You set a per-download price from $0.01 upward, and Loomal takes 5% on settled transactions — a fee that is currently waived.
Have a file worth paying for?
Upload it, set a price, share the URL. Agents handle the rest.