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
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.
Pin by CID
When using the Pin By CID endpoint or using it in the Files page in the app, there is a limit of 250 items that can be in the queue at once.
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!