polymer-pay-pinata

Pin and retrieve IPFS files via Polymer Pay proxy with per-use pricing.

1|2|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/polymerdao/pay-apis --skill polymer-pay-pinata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymer-pay-pinata
Source: https://github.com/polymerdao/pay-apis/tree/main/skills/polymer-pay-pinata
Command: npx skills add https://github.com/polymerdao/pay-apis --skill polymer-pay-pinata

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pin a pay-per-use IPFS pinning and retrieval capability through the Polymer Pay proxy; no Pinata account or separate API key required for IPFS interactions.

Core Features & Use Cases

  • Pin a file to the public IPFS network via /v1/pin/public
  • Pin a file to the private IPFS network via /v1/pin/private
  • Retrieve a privately pinned file by CID via /v1/retrieve/private/{cid}
  • All requests route through the Polymer Pay proxy and require POLYMER_PAY_API_KEY for authentication

Quick Start

Pin files to IPFS through the Polymer Pay proxy using the provided endpoints and your API key.

Frequently Asked Questions about polymer-pay-pinata

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I pin files to IPFS without creating a separate Pinata account?

You can pin files to IPFS without a Pinata account by routing requests through the Polymer Pay proxy, which requires only a valid POLYMER_PAY_API_KEY for authentication and per-use pricing.

What is pay-per-use IPFS pinning and how does it work?

Pay-per-use IPFS pinning allows you to store and retrieve files on the IPFS network by paying for each request individually through the Polymer Pay proxy, using your POLYMER_PAY_API_KEY for authentication instead of a subscription.

How do I retrieve a privately pinned file on IPFS using its CID?

To retrieve a privately pinned file on IPFS, send a request to the /v1/retrieve/private/{cid} endpoint through the Polymer Pay proxy, providing your POLYMER_PAY_API_KEY and the specific CID of the file.

Can I pin files to both public and private IPFS networks with this approach?

Yes, you can pin files to the public IPFS network via the /v1/pin/public endpoint and to the private IPFS network via /v1/pin/private, with both requests requiring a POLYMER_PAY_API_KEY for proxy authentication.

Do I need a Pinata API key to use pay-per-use IPFS pinning via Polymer Pay?

No, you do not need a Pinata API key or account; all IPFS interactions are authenticated using a valid POLYMER_PAY_API_KEY routed through the Polymer Pay proxy for per-use billing.

What are the limitations of using a proxy for IPFS pinning and retrieval?

The primary limitation is that all IPFS pinning and retrieval requests must route through the Polymer Pay proxy and include a valid POLYMER_PAY_API_KEY, meaning direct IPFS or Pinata API access is not supported within this workflow.