# Getting Started

### Receive an API key <a href="#id-2-create-an-api-key" id="id-2-create-an-api-key"></a>

You must receive an API key to authenticate your network requests.

An API key is received after setting up your account and plan on [www.sandshrew.io ](https://www.sandshrew.io/).

Additional support can be found on our Discord at <https://discord.gg/xhWzbFMmxG> or by [contacting Drorjen on telegram](https://t.me/DrorjenOYL).

### Sign up for Sandshrew

You will need an API key to interact with Sandshrew. To sign up for an account on the Sandshrew website, enter your details, and select **SIGN UP**.

<figure><img src="https://1621931615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP960bUxwZraZAsN5DlEf%2Fuploads%2FPkctbXxjLXohW9pwVwyh%2FSignup.gif?alt=media&#x26;token=a5877d74-d151-4c19-829c-56d781ccb690" alt=""><figcaption><p>Sign up </p></figcaption></figure>

### Choose your plan&#x20;

Get started for Free or sign up for developer or team packages to get more RPC calls. If you have unique requirements or need more calls per day, reach out to @drorjen\_oyl on telegram.&#x20;

<figure><img src="https://1621931615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP960bUxwZraZAsN5DlEf%2Fuploads%2FoBmcXSdctjO8ej86QQu8%2FChoose%20Plan.gif?alt=media&#x26;token=acb9b4e6-672f-4532-a32b-09c71716b558" alt=""><figcaption><p>Choose Plan</p></figcaption></figure>

### Create an API key <a href="#id-2-create-an-api-key" id="id-2-create-an-api-key"></a>

Once verified, you’ll be taken to the Sandshrew Dashboard where you can create your API key, view analytics, or raise support requests.

You must create an API key to authenticate your network requests. Click **CREATE NEW API KEY**.

From the pop-up, provide a name, then click **CREATE**.

<figure><img src="https://1621931615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP960bUxwZraZAsN5DlEf%2Fuploads%2F8fy4CVqEKPvO2HT8IGsE%2FGet%20Key.gif?alt=media&#x26;token=30163377-b36c-4539-a991-29e8bb214549" alt=""><figcaption><p>Get your key</p></figcaption></figure>

## Testing

Once you have your API key, you can query the RPC with a command similar to the following:

```
curl https://mainnet.sandshrew.io/v1/YOUR-API-KEY \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "esplora_blocks:tip:height",
    "params": []
}'
```

Your API key grants you access to all SANDSHREW namespaces, for all networks supported by SANDSHREW, identified by the subdomain in the URI. In the preceding example, the RPC will serve data for the signet network.

## Network Endpoints

### Querying the RPC <a href="#querying-the-rpc" id="querying-the-rpc"></a>

To fetch data, create an HTTPS POST request to any one of the following endpoints with the following header set:`Content-Type: application/json`and with the request, submit a JSON-RPC payload as the POST data containing your method call.

### Bitcoin <a href="#bitcoin" id="bitcoin"></a>

`https://mainnet.sandshrew.io/v1/YOUR-API-KEYhttps://signet.sandshrew.io/v1/YOUR-API-KEYhttps://testnet.sandshrew.io/v1/YOUR-API-KEY`

### Dogecoin <a href="#dogecoin" id="dogecoin"></a>

`https://dogecoin-mainnet.sandshrew.io/v1/YOUR-API-KEYhttps://dogecoin-testnet.sandshrew.io/v1/YOUR-API-KEY`*(Dogecoin endpoints currently do not support the `esplora` or `ord` namespaces)*
