{"uid":"cap_5cZ17bbxD6aAICmJUzFNF","slug":"x402engine-ipfs-content-retrieval-8dd2ba8d","name":"x402engine IPFS Content Retrieval","description":"Fetch a file from IPFS by CID via gateway","url":"https://x402engine.app/api/ipfs/get","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["cid"],"properties":{"cid":{"type":"string","example":"QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG","description":"IPFS CID"}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_d6LbYzm8jnLfDL8-B_yGl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches content stored on IPFS by CID via a pay-per-call HTTP 402 micropayment gateway","exampleAgentPrompt":"Can you fetch the content stored at IPFS CID QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG for me?","exampleUseCases":[{"title":"Retrieve NFT metadata from IPFS","prompt":"I need to read the metadata JSON for this NFT — it's stored at IPFS CID QmNLei78zWmzUdbeRB3CiUfAizWUrbeeZh5K1rhAQKCh51. Can you fetch it?"},{"title":"Access decentralized document archive","prompt":"Pull the content of the whitepaper stored at IPFS hash QmT5NvUtoM5nWFfrQdVrFtvGfKFmG7AHE8P34isapyhCxX so I can read it."},{"title":"Verify on-chain data reference","prompt":"There's an IPFS CID referenced in this smart contract — QmXoypizjW3WknFiJnKLwHCnL72vedxjQkDDP1mXWo6uco — can you retrieve what's actually stored there?"}],"resultDescription":"Returns the raw content stored at the given IPFS CID — this could be JSON, text, binary data, images, or any other file type that was pinned to IPFS. The response body contains the file content directly.","failureModes":["Invalid or malformed CID returns an error","Content not found or unpinned on IPFS network results in a timeout or 404","Payment failure via HTTP 402 if USDC/USDm balance is insufficient","Network timeout if IPFS peers holding the content are unreachable","Large files may be slow or fail if retrieval takes too long"],"whenToPreferThis":"Use this endpoint when an AI agent needs to retrieve content from IPFS without operating its own node or gateway — ideal for reading NFT metadata, decentralized app data, or any content-addressed file referenced by a CID on-chain. Prefer this over public IPFS gateways when you need reliable, pay-per-call access integrated into an agent payment flow using USDC or USDm.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:47:34.683Z","isFirstParty":false}