Pay-per-file IPFS content retrieval via x402 on Base Sepolia testnet
What it does
This endpoint serves IPFS-pinned content behind an x402 paywall, hosted on a Pinata-based gateway (grapevine.dev-mypinata.cloud). When a GET request is made to the endpoint with a specific CID (Content Identifier), the server returns an HTTP 402 challenge requiring a micropayment of 0.002006 USDC on the Base Sepolia testnet before delivering the file. The response MIME type is application/octet-stream, indicating raw binary/file content.
The x402 challenge uses the "exact" payment scheme with a 60-second timeout. Payment is directed to address 0x6e62FF0591d4D8a0E5A1C274AbCFd2D716F1035E using the USDC token contract at 0x036CbD53842c5426634e7929541eC2318f3dCF7e on Base Sepolia. The endpoint follows x402 version 1 protocol and expects a valid x-payment header to authorize content access.
Note that this endpoint operates on Base Sepolia, which is a testnet — meaning the USDC tokens used are not real-value tokens. The crawled site provides no documentation, no OpenAPI spec, and no additional context beyond the x402 challenge itself. The gateway appears to be a CID-based content delivery system where each CID path may have its own pricing. Without further documentation, the scope and catalog of available content behind this gateway is unknown.
Capabilities
Use cases
- —Retrieving IPFS-pinned files behind a micropayment gate
- —Testing x402 payment flows on Base Sepolia testnet
- —Paying for individual content items stored on IPFS
- —Agent-driven file purchases using USDC micropayments
Fit
Best for
- —Developers testing x402 protocol integrations on testnet
- —Agents that need to fetch paywalled IPFS content programmatically
- —Prototyping pay-per-file content delivery systems
Not for
- —Production/mainnet file purchases (this is on Base Sepolia testnet)
- —Browsing or discovering available content (no catalog or listing endpoint)
- —Streaming or large-scale bulk downloads (no documented batch support)
Quick start
# 1. GET the endpoint to receive the x402 challenge
curl -i https://grapevine.dev-mypinata.cloud/x402/cid/bafkreid47pctc75gkd66hoxd7pj5iiyzy2n5gloonxpu2h4ct2lsahv3oe
# Returns 402 with x402 challenge JSON
# 2. Construct an x-payment header per x402 spec and resend:
curl -H "x-payment: <signed-payment-token>" \
https://grapevine.dev-mypinata.cloud/x402/cid/bafkreid47pctc75gkd66hoxd7pj5iiyzy2n5gloonxpu2h4ct2lsahv3oe
# Returns the file as application/octet-streamExample
Response
{
"error": "Provide a valid x-payment header to access this content",
"accepts": [
{
"asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
"extra": {
"name": "USDC",
"version": "2"
},
"payTo": "0x6e62FF0591d4D8a0E5A1C274AbCFd2D716F1035E",
"scheme": "exact",
"network": "base-sepolia",
"mimeType": "application/octet-stream",
"resource": "https://grapevine.dev-mypinata.cloud/x402/cid/bafkreid47pctc75gkd66hoxd7pj5iiyzy2n5gloonxpu2h4ct2lsahv3oe",
"description": "0.002006 USDC on base-sepolia",
"maxAmountRequired": "2006",
"maxTimeoutSeconds": 60
}
],
"x402Version": 1
}Endpoint
Quality
The x402 challenge is live and well-formed, confirming the endpoint works. However, there is zero documentation, no OpenAPI spec, no site content beyond error messages, and the endpoint is on a testnet. All descriptive details are inferred solely from the 402 challenge payload.
Warnings
- —No documentation or OpenAPI spec available from the provider
- —Operates on Base Sepolia testnet — USDC tokens have no real monetary value
- —The content behind this CID is unknown (application/octet-stream with no description of what the file contains)
- —All crawled pages returned error messages; the gateway provides no discoverability or catalog
Citations
- —The endpoint returns a 402 challenge requiring 0.002006 USDC on Base Sepoliahttps://grapevine.dev-mypinata.cloud/x402/cid/bafkreid47pctc75gkd66hoxd7pj5iiyzy2n5gloonxpu2h4ct2lsahv3oe
- —Payment is directed to address 0x6e62FF0591d4D8a0E5A1C274AbCFd2D716F1035E using USDC contract 0x036CbD53842c5426634e7929541eC2318f3dCF7ehttps://grapevine.dev-mypinata.cloud/x402/cid/bafkreid47pctc75gkd66hoxd7pj5iiyzy2n5gloonxpu2h4ct2lsahv3oe
- —The response MIME type is application/octet-streamhttps://grapevine.dev-mypinata.cloud/x402/cid/bafkreid47pctc75gkd66hoxd7pj5iiyzy2n5gloonxpu2h4ct2lsahv3oe
- —Root and all other crawled paths return error messages with no useful contenthttps://grapevine.dev-mypinata.cloud