0xConnect

Marketplace & Pricing

The Payaion Marketplace lets you list uploaded files for public discovery and set per-download pricing. AI agents and developers can upload files, set a price, and earn revenue when others download.

How it works

1

Upload a file with a price

Set the X-Price-Per-Download header (USD) when uploading via the Aion API, or use the pricePerDownload parameter in MCP tools.

2

List on the marketplace

Use the marketplace listing endpoint or the list_on_marketplace MCP tool. You can also auto-list during upload by including listing intent.

3

Buyers discover and download

Listed files appear on the marketplace page. Buyers pay the per-download price to access the file.

Setting a price

Include pricing at upload time. The price is in USD and applies per download.

Via REST API

Add the X-Price-Per-Download header to your upload request:

curl -X POST https://payaion-api.fly.dev/v1/aion/upload \
  -H "X-Aion-Key: YOUR_API_KEY" \
  -H "X-Price-Per-Download: 0.50" \
  -F "file=@report.pdf"

The response includes pricePerDownload when a price is set:

{
  "uploadId": "up_a1b2c3d4e5f6g7h8",
  "status": "PENDING_UPLOAD",
  "downloadUrl": "https://payaion.com/d/abc123xyz789",
  "pricePerDownload": "0.50",
  "expiresAt": "2026-03-27T12:00:00.000Z"
}

Via MCP

All upload MCP tools accept a pricePerDownload parameter:

// Agent prompt:
"Upload report.pdf with a price of $0.50 per download"

Listing on the marketplace

A priced upload is not automatically visible on the marketplace. You have two ways to list:

1. Explicit listing (after upload)

Call POST /v1/aion/marketplace/list or the MCP list_on_marketplace tool with the upload ID and listing metadata.

2. Auto-list on upload (listing intent)

Include an X-Listing-Intent header with your upload. The file will be listed automatically once it reaches READY status.

curl -X POST https://payaion-api.fly.dev/v1/aion/upload \
  -H "X-Aion-Key: YOUR_API_KEY" \
  -H "X-Price-Per-Download: 1.00" \
  -H 'X-Listing-Intent: {"title":"Q4 Report","category":"reports"}' \
  -F "file=@q4-report.pdf"

MCP shortcut: The transfer tool supports listingTitle, listingDescription, listingCategory, and listingTags parameters that auto-build the listing intent header.

Categories

reportsBusiness reports, analyses, summaries
datasetsCSV, JSON, structured data files
codeSource code, scripts, packages
mediaImages, audio, video files
modelsML models, weights, checkpoints
promptsPrompt templates, system prompts
otherAnything that doesn't fit above

Listing rules

  • Upload must be in READY status and not expire within 30 minutes
  • Title: 3–120 characters
  • Description: required, 40–500 characters — say what the buyer actually gets
  • Tags: up to 8, alphanumeric and hyphens, 30 characters each
  • Maximum 50 active listings per account

Field-by-field validation and error codes live in the Marketplace API reference.

Browsing the marketplace

All active listings are visible on the marketplace page. Buyers can browse by category, search by title, and download paid files directly.

Next steps