Why limits?¶
NSF’s National Geophysical Facility services provide open access to scientific data. Usage limitations are enforced to ensure these services remain accessible to the broadest possible audience and protect them from errant or malicious usage.
At a glance¶
| Anonymous | Authenticated | |
|---|---|---|
| Metadata access | Yes | Yes |
| Data product access | Until Dec 15, 2026 | Yes |
| Request rate | 3,000 req / min | 3,000 req / min |
| Hourly quota | 10 GiB | 200 GiB |
| Daily quota | 50 GiB | 1 TiB |
| Quota tracked by | IP address | User account |
What counts vs. what gets blocked¶
Everything counts toward your quota, but only data products are blocked.
| Counts toward quota | Blocked when over quota | |
|---|---|---|
Data products (e.g. fdsnws-dataselect) | Yes | Yes |
Metadata (e.g. fdsnws-station) | Yes | No |
Over quota, you can still fetch station metadata, but dataselect returns 429 until your window resets. Large metadata pulls still add to your usage.
How a request is evaluated¶
As of December 15, 2026:
What you’ll see when blocked¶
| Reason | Status | Response |
|---|---|---|
| Over quota | 429 | Plain-text body naming the user or IP that was limited, plus a Retry-After header |
| Over the request rate | 429 | No body; Retry-After: 60 |
Over quota, Retry-After is the number of seconds until your block ends. Requests that send an EarthScope bearer token are checked against your account’s quota; all other requests are checked against your IP address. If you share an IP with other users (for example, a campus network or cloud egress), signing in means another user’s usage can’t block you.
HTTP/1.1 429 Too Many Requests
Content-Type: text/plain; charset=utf-8
Cache-Control: no-store
Retry-After: 1834
Your request was temporarily blocked for exceeding your quota.
IP: 203.0.113.42
Request ID: 4TyzHTaYWb1GX1qTfsHhEqV6HUDd_BzoBZnwfnvQc_1oF26ClkoUSEQ==
Learn about usage quotas: https://docs.earthscope.org/user-limitsHTTP/1.1 429 Too Many Requests
Content-Type: text/plain; charset=utf-8
Cache-Control: no-store
Retry-After: 1834
Your request was temporarily blocked for exceeding your quota.
User: auth0|abc123
Request ID: 4TyzHTaYWb1GX1qTfsHhEqV6HUDd_BzoBZnwfnvQc_1oF26ClkoUSEQ==
Check your quota usage: https://www.earthscope.org/user/quota
Learn about usage quotas: https://docs.earthscope.org/user-limitsGetting more headroom¶
Use an EarthScope user account¶
An account is required for data products from December 15, 2026 and gives you 20× the anonymous quota, tracked by account rather than IP.
Sign up for a free EarthScope user account.
Sign in from the command line.
Sign in from Python.
Request only what you need¶
Narrow time windows and channel selections reduce transfer size.
Need more than the quotas allow? Use direct access to S3¶
For bulk downloads or large-scale processing, read miniSEED directly from Amazon S3. Direct access does not count toward your quota.
Networks: A select subset (view list)
Requires: Nothing. Free from anywhere, no account needed.
Networks: All other networks
Requires: Reads must run in AWS us-east-2.
Questions or errors¶
Blocked in error, or need more than these limits allow? Email help@earthscope.org with the User ID or IP from the response message saying you were blocked.