{"uid":"cap_pfLpMtGaKWnYAL3nvmepI","slug":"x402engine-ipfs-pin-03456073","name":"x402engine IPFS Pin","description":"Pin JSON, files, or URLs to IPFS for decentralized storage","url":"https://x402engine.app/api/ipfs/pin","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"type":"object","properties":{"url":{"type":"string","example":"https://example.com/file.jpg","description":"URL of file to pin (provide json OR url, not both)"},"json":{"type":"object","example":{"hello":"world"},"description":"JSON object to pin (provide json OR url, not both)"},"name":{"type":"string","example":"data:image/png;base64,...","description":"Base64-encoded file"}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sVCUKTVWkKvKHuQ8Z1ySO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Pins JSON objects, files, or URLs to IPFS for permanent decentralized storage, returning a content-addressed CID","exampleAgentPrompt":"Pin this JSON metadata to IPFS for my NFT: {\"name\": \"CryptoPunk #001\", \"description\": \"A rare punk\", \"image\": \"https://example.com/punk001.png\"} — I need the IPFS CID back.","exampleUseCases":[{"title":"NFT metadata pinning for smart contract","prompt":"I need to store my NFT metadata on IPFS before minting — pin this JSON object for me: {\"name\": \"Galaxy Dragon #42\", \"description\": \"A legendary dragon NFT\", \"attributes\": [{\"trait_type\": \"color\", \"value\": \"purple\"}]} and give me the CID."},{"title":"Decentralized backup of config file","prompt":"Pin the JSON config file at https://myapp.com/config/production.json to IPFS so I have a permanent, content-addressed backup I can reference immutably."},{"title":"Permanent storage of agent-generated report","prompt":"I just generated a research report as JSON and I need to store it permanently on IPFS — pin this object: {\"title\": \"Q2 Market Analysis\", \"summary\": \"Crypto markets rose 12%\", \"date\": \"2025-06-01\"} and return the IPFS hash."}],"resultDescription":"Returns an IPFS CID (content identifier) and gateway URL confirming the data has been pinned to the IPFS network, allowing permanent content-addressed retrieval via any IPFS gateway.","failureModes":["Invalid or unreachable URL provided — returns error if the target URL cannot be fetched","Both json and url provided simultaneously — schema only allows one at a time","Malformed JSON body — returns 400 if the object structure is invalid","Payment failure — returns HTTP 402 if USDC micropayment is not included or insufficient","IPFS node unavailable — transient pinning failure if the underlying IPFS infrastructure is unreachable"],"whenToPreferThis":"Choose this endpoint when you need a simple pay-per-use IPFS pinning service without managing your own IPFS node or Pinata/web3.storage account. Ideal for AI agents that occasionally need to pin NFT metadata, configuration snapshots, or arbitrary JSON to IPFS within an x402 micropayment workflow. At $0.01 USDC per call it is cost-effective for low-to-medium volume pinning needs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:48:25.748Z","isFirstParty":false}