Name: ipfs-gateway
Price: 0.005 USDC
Availability: InStock

$ man ipfs-gateway

agentutility / edge-market / ipfs-gateway

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

edgemarket

CATEGORY

uncategorized

STATUS

● live

NAME

ipfs-gateway — reads a cid through a fallback chain of public ipfs gateways and returns content type, size, gateway used, and body as base64, text, or json

synonym alias of ipfs-fetch — reuses the canonical handler.

SYNOPSIS

POST https://x402.agentutility.ai/ipfs-gateway
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Reads a CID through a fallback chain of public IPFS gateways and returns content type, size, gateway used, and body as base64, text, or JSON. Use it as an IPFS gateway API, CID gateway resolver, or decentralized file retrieval tool.

INPUT — request schema

property	type	description	req?
cid	string	IPFS CID, CIDv0 (Qm... base58, 46 chars) or CIDv1 (bafy... base32). Required.	required
path	string	Optional sub-path inside the IPFS directory, e.g. '/index.html' or 'metadata.json'. Leading slash optional.	optional
max_bytes	number	Maximum response size in bytes. Default 1000000 (1 MB). Hard-capped at 5000000 (5 MB).	optional
output	string	How to return the content. 'base64' (default — safe for binary), 'text' (UTF-8 decode), or 'json' (UTF-8 decode + JSON.parse). Returns 502 if 'json' is requested and the body doesn't parse. enum: base64 · text · json	optional

OUTPUT — response shape

field	type	description
cid	string	—
gateway_used	string	—
content_type	string	—
size_bytes	string	—
content	string	—
source	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/ipfs-gateway \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the ipfs-gateway tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: edge-marketipfsgatewayipfs-gateway
methods: POST
cluster: edgemarket
price: $0.005 USDC per call

ADJACENT — other endpoints in edgemarket

endpoint	description	price
agent-card-resolve	Resolves an ERC-8004 agentId to its on-chain owner, agentURI, and agent card JSON.	$0.005
arbitrage-spread	Finds the cross-exchange arbitrage spread for any CoinGecko-listed coin.	$0.005
basename-resolve	Resolves Coinbase Basenames (.base.eth) to Ethereum addresses and back, reading the Base mainnet L2 Resolver on-chain (no gas, no wallet).	$0.005
cid-fetch	Fetches the content behind an IPFS CID and optional path through public gateways, returning text, JSON, or base64 with a 5 MB cap.	$0.005
current-balance	Reads a wallet's current ERC-20 token balance with a read-only balanceOf call on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, or Ava…	$0.005
defi-yield-pools	Filters and ranks thousands of DeFi yield-bearing pools by APY across every chain DeFiLlama tracks.	$0.005
erc20-balance	Reads an ERC-20 token balance on-chain across any supported EVM chain, including Base, Ethereum, Arbitrum, Optimism, and Polygon.	$0.005
erc20-metadata	Reads ERC-20 token metadata: name(), symbol(), decimals(), and totalSupply() in parallel via public RPC on Base, Ethereum, Arbitrum, Opti…	$0.005