# IPFS Upload with Micropayment Staging (ipfs.c402.markets)

> IPFS Upload with Micropayment Staging (ipfs.c402.markets) is a paid API for AI agents from ipfs.c402.markets, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Accepts a 2¢ USDC micropayment via x402, then stages an image file plus metadata payload for pinning to IPFS, returning an upload ID and file details.

## Facts

- Endpoint: POST https://ipfs.c402.markets/ipfs-upload
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ipfs-c402-markets-4c7f09b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6w-NeZTQ2pc8qojGFtkHd

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 ipfs-c402-markets-4c7f09b1 -d '<json body>'
```

Example prompt: Upload this product image (product-hero.png, image/png) along with its metadata to IPFS — pay the 2¢ USDC staging fee automatically and give me the upload ID and IPFS details when it's done.

## When to prefer this

Choose this endpoint when you need to stage and pin files to IPFS using a pay-per-use micropayment model (x402 / USDC) rather than a subscription API key — ideal for Web3 apps, NFT metadata pipelines, or any workflow that needs decentralized, content-addressed storage without a recurring billing relationship.

## Known failure modes

- Payment insufficient or rejected — x402 payment of 0.02 USDC not provided or declined, upload not staged
- Invalid image format — unsupported mimeType causes rejection
- Payload too large — image or metadata exceeds size limits
- Missing required fields — no image or metadata body provided
- Network/IPFS gateway error — staging service temporarily unavailable
- Settlement transaction failure — payment accepted but on-chain settlement pending or null

## How this service works

Pay 2¢ USDC to stage an image plus metadata payload before it is pinned to IPFS.

## Output

Returns a JSON object with an uploadId, the image details (filename, mimeType, size), metadata details (filename, size, preview), the payment amount charged, the settlement transaction hash (if available), and a status string indicating whether staging succeeded.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ipfs-c402-markets-4c7f09b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ipfs.c402.markets](https://www.zero.xyz/host/ipfs.c402.markets/llms.txt)