Limits

The Pinata platform currently has the following rate limits in place:

API Rate Limits

The Pinata API currently has a rate limit of 180 requests per minute to our API.

Exceptions

The following API calls have increased rate limits:

Endpoints under the /data/ route have a rate limit of 30 requests per minute
The Pinning Services API endpoint for listing content has a rate limit of 30 requests per minute

Recommendations

For users with traffic that can be burst-heavy, we recommend using a task scheduler or queue-based upload approach that limits requests to the allowed amount.

For NodeJS users specifically, we recommend the bottleneck library to help with this.

Public Gateway Rate Limits

The Pinata public IPFS gateway (gateway.pinata.cloud) is meant for testing purposes or very low volume retrieval and should not be used in production scenarios. It currently has the following rate limits:

Each CID has a global rate limit of 15 requests per minute (this is across all IP addresses)
Each IP address has a rate limit of 200 requests per minute

Dedicated Gateway Rate Limits

At this time there are currently no rate limits for users retrieving content from a dedicated gateway.

Upload Size Limits

🚧
While the upload limit is 25GB we would recommend only uploading up to 15GB per file/folder for reliability reasons. We can try to assist uploads 15GB-25GB but we cannot guarantee success at this time.

There is no aggregate limit for uploads, but each individual upload (whether it is a file or a folder) is limited to 25 GB.

There is also a file limit size of 10MB for the pinJSONToIPFS API endpoint.

Free Plan Restrictions

The free plan currently does not allow HTML files to be uploaded or allow them to go through the free plan Dedicated Gateway. If you wish to use such file types you can upgrade to a paid plan!