Ipfs Fetch

Fetches IPFS content by CID through public gateways and returns it as base64, UTF-8 text, or parsed JSON.

Overview

Fetches IPFS content by CID through public gateways and returns it as base64, UTF-8 text, or parsed JSON. Resolves a CID (CIDv0 Qm... or CIDv1 bafy...) and optional sub-path through a fallback chain of public gateways (cloudflare-ipfs.com, ipfs.io, dweb.link). Hard cap 5 MB with HEAD pre-flight and streaming size guard so oversized files are rejected before full download. Use it as an IPFS gateway API, CID resolver, Web3 storage retrieval, NFT metadata fetcher, Filecoin gateway, or decentralized content reader.

Endpoint

Method	Endpoint	Price	Description
POST	/v1/marketplace/api/ipfs-fetch	$0.00575	Invoke Ipfs Fetch (Storage) and return the upstream response.

How to call it

Requests are paid per call over the x402 protocol. Call the endpoint, receive a 402 Payment Required quote, then repeat the request with the signed payment header. The SDKs do both steps for you.

# 1. Ask for a quote
curl -i -X POST https://api.jarvisclaw.ai/v1/marketplace/api/ipfs-fetch \
  -H 'Content-Type: application/json' \
  -d '{}'

# 2. Pay it (the SDK signs and retries for you)
curl -X POST https://api.jarvisclaw.ai/v1/marketplace/api/ipfs-fetch \
  -H 'Content-Type: application/json' \
  -H 'X-PAYMENT: <signed-payload>' \
  -d '{}'

Open in the marketplace