# httpay.xyz API Gateway: Pinata IPFS Pinning

> httpay.xyz API Gateway: Pinata IPFS Pinning is a paid API for AI agents from httpay.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-08).

Proxies requests to the Pinata IPFS pinning service API, enabling pinning of files and JSON to IPFS via a pay-per-call gateway

## Facts

- Endpoint: POST https://httpay.xyz/api/gateway/pinata/%7B*path%7D/*
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/httpay-xyz-bf275dd0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9cfF8nSbdX3EL5crvqoRY

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 httpay-xyz-bf275dd0 -d '<json body>'
```

Example prompt: Pin this JSON metadata to IPFS using Pinata: {"name":"My NFT #1","description":"A cool NFT","image":"ipfs://QmExampleHash"} — I need the IPFS CID back.

## When to prefer this

Choose this endpoint when you need to pin content to IPFS via Pinata without managing your own Pinata API credentials, and you prefer a pay-per-call micro-payment model (x402/USDC) over a subscription. Useful for agents and workflows that occasionally pin NFT metadata, files, or JSON blobs to IPFS in a serverless, keyless manner.

## Known failure modes

- Invalid or malformed request body returns 400 from Pinata
- Content too large exceeds Pinata plan limits
- Pinata upstream service unavailable returns 502/503
- Payment not fulfilled causes 402 Payment Required from the gateway
- Unsupported Pinata API path in wildcard route returns 404

## How this service works

API Gateway: Pinata IPFS pinning service API

## Output

Returns the Pinata API response for the pinning operation, including the IPFS CID (IpfsHash), pin size, and timestamp of when the content was pinned to IPFS.

## More

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