API keys

You can use the same API key for different Snapshot APIs. Limits are counted individually per each API Service.

How can I get an API Key?

1. Apply via the request form

If you haven’t already please fill in the below form or submit it via the direct link.

API Key Request Form

2. Wait 72 hours

We will review your submission and whitelist the address you provided in the form.

Once whitelisted, you will receive an email with your API key. If you haven’t received an email after 72 hours, please contact our support on Help center.

You can also see your key and its usage at any time under Settings → API keys in the Snapshot app, signed in with the whitelisted address.

How to structure the query with my key?

The only change you need to make is to add the API Key in the headers of your request:

curl 'https://hub.snapshot.org/graphql?' \
  -H 'content-type: application/json' \
  -H 'x-api-key: <YOUR-API-KEY>' \
  --data-raw '{"query":"\n{\n space(id:\"snapshot.dcl.eth\"){\n  id\n  name\n  members\n}\n}","variables":null}' \
  --compressed

Alternatively, you can use the apiKey param in the query string with your key as a value:

curl 'https://hub.snapshot.org/graphql?apiKey=<YOUR_API_KEY>' \
  -H 'content-type: application/json' \
  --data-raw '{"query":"\n{\n space(id:\"snapshot.dcl.eth\"){\n  id\n  name\n  members\n}\n}","variables":null}' \
  --compressed

If you are using the GraphQL interface you need to provide your key in the headers tab:

Getting started

Guides

Tools

Snapshot X

Limits

How can I get an API Key?

1. Apply via the request form

API Key Request Form

2. Wait 72 hours

How to structure the query with my key?

​Limits

​How can I get an API Key?

​1. Apply via the request form

​API Key Request Form

​2. Wait 72 hours

​How to structure the query with my key?

Limits

How can I get an API Key?

1. Apply via the request form

API Key Request Form

2. Wait 72 hours

How to structure the query with my key?