ipfs.hoodfi.eth
An x402 service on Robinhood Chain

Pin a file to IPFS. Pay once.

Send a file, pay one cent in USDG with x402, get a CID back. No account, no API key, no subscription: built for AI agents that need to publish something and move on.

Per pin$0.01
Up to1 MB
Kept for2 years
View on x402Fi API reference

How it works

  1. Send the file

    POST it to the pin endpoint. Any content type, or multipart with a file field.

  2. Pay the 402

    The answer is an x402 price quote. Your wallet signs a USDG authorization; no gas, no approval.

  3. Get the CID

    Repeat the request with the payment. It comes back with the CID, gateway links and the date it is pinned until.

You are charged only when the pin succeeds. An empty body, a file over 1 MB or a storage error is answered with an error and the payment is never settled.

For AI agents

Add x402Fi's MCP server to Claude, Cursor or any MCP client. It finds this service and returns the exact payment requirements; your agent pays with its own x402 wallet.

https://x402fi.dev/mcp

Then ask: "Find an IPFS pinning service on x402Fi and pin this file." The service is also in x402Fi's Bazaar discovery feed, with its call format, for agents that read feeds instead.

Try the quote

An unpaid call costs nothing and shows the price:

# returns 402 with the price, payTo and payee name
curl -X POST \
  "https://x402fi.dev/g/ipfs-pinning/pin?name=hello.json" \
  -H "content-type: application/json" \
  -d '{"hello":"world"}'

API

EndpointPrice
POST https://x402fi.dev/g/ipfs-pinning/pin
Pins the request body, up to 1 MB. Optional ?name=report.pdf.		$0.01
GET https://ipfs.x402fi.dev/status/<cid>
Whether a CID is pinned here, and until when.		free

A paid pin answers 201:

{
  "cid": "bafkreietui4xdkiu4xvmx4fi2jivjtndbhb4drzpxomrjvd4mdz4w2avra",
  "name": "hello.json",
  "size": 17,
  "ipfs_url": "ipfs://bafkreietui4x…avra",
  "gateway_url": "https://gateway.pinata.cloud/ipfs/bafkreietui4x…avra",
  "pinned_until": "2028-11-12T19:02:23.000Z"
}

Good to know

  • Pins last 2 years, then they are unpinned. pinned_until is in every response.
  • Pinning the same bytes again returns the same CID.
  • A new pin can take a few minutes to reach public gateways.
  • Everything you pin is public on IPFS. Don't pin secrets.

Who you pay

  • Payee name ipfs.hoodfi.eth, a HoodFi name on Robinhood Chain. x402Fi checks that it lists this service and its payout wallet.
  • Payout wallet 0x17BD1f7B015e5a274aA519b1b7d027b4426fC433
  • Settled by x402Fi's facilitator in USDG on Robinhood Chain (eip155:4663), with a public receipt for every payment.