{"uid":"cap_Y-28PqH14YmZ7F-fcdWPR","slug":"enclave402-ipfs-json-pin-022cb8d6","name":"enclave402 IPFS JSON Pin","description":"Enclave402: x402 pay-per-call gateway on Base. Live Polymarket signals, IPFS pinning, EIP-712 attestations. Receipt-gated settlement, replay protection, no charge on failure.","url":"https://enclave402.com/api/storage/pin","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"description":"Optional human label stored with the pin."},"content":{"type":["object","string"],"examples":[{"at":1789650000,"agent":"planner-1","decision":"hold"}],"description":"JSON object or string to store (serialized size up to 8 KB)."}}},"responseSchema":{"type":"json","example":{"ts":1767225600000,"cid":"bafkreigh2akiscaildcqabsyg3dfr6chu3fgpregiymsck7e7aqa4s52zy","size":52,"pinned":true,"status":"pinned","gateway":null,"settled":true,"provider":"pinata"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Kg7JKkMmBB0ay05cQEdXP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stores a JSON document (up to 8 KB) on IPFS via a managed pinning service and returns the CID v1 and a gateway URL, settling $0.008 USDC via x402 on Base.","exampleAgentPrompt":"Pin this JSON decision record to IPFS for me — label it 'planner-1-hold' and store the object {\"at\":1789650000,\"agent\":\"planner-1\",\"decision\":\"hold\"} so I can reference it by CID later.","exampleUseCases":[{"title":"Persisting agent decision log","prompt":"Store this decision object on IPFS so I can share it with downstream agents by CID: {\"at\":1789650000,\"agent\":\"planner-1\",\"decision\":\"buy\",\"confidence\":0.87} — label it 'trade-decision-001'."},{"title":"Archiving multi-agent coordination artifact","prompt":"I need durable storage for this coordination metadata from my agent fleet — pin the JSON {\"round\":5,\"consensus\":\"proceed\",\"agents\":[\"scout\",\"planner\",\"executor\"]} to IPFS and give me the content identifier."},{"title":"Saving AI-generated report metadata","prompt":"Take this summary object — {\"report\":\"Q2 analysis\",\"generated\":1767225600000,\"findings\":\"growth positive\"} — and pin it to IPFS under the label 'q2-report-meta' so I can fetch it by CID from any agent later."}],"resultDescription":"Returns a JSON object containing the CID v1 content identifier, the pin status ('pinned'), the document size in bytes, a timestamp, a boolean indicating whether the $0.008 USDC payment settled, the provider name (Pinata), and an optional HTTP gateway URL for direct retrieval.","failureModes":["Content exceeds 8 KB — pin rejected, no charge","Content is raw binary or non-JSON — rejected at validation","Pinning service temporarily unavailable — pin fails, no charge","CID re-pin attempt submitted — not supported, use a different endpoint","Malformed JSON in content field — request rejected","x402 payment settlement failure — pin not created, no charge"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to persist a JSON object or string in a content-addressed, decentralized way so that any other agent or system can later retrieve it deterministically by CID. Prefer it over centralized key-value stores when immutability, verifiability, or cross-agent shareability of the stored artifact is required. Best for documents under 8 KB such as decisions, memory snapshots, coordination metadata, or lightweight artifacts. Do not use for binary files, large payloads, or re-pinning existing CIDs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:37:44.227Z","isFirstParty":false}