# Getting Started

## 📋 Overview 

This guide assumes you already have an Alchemy Crypto.org account and access to our [Dashboard](https://cro-dashboard.alchemyapi.io/).

**1**. 🔑 Create an Alchemy App

**2**. ✍ Make a request

## 1.:key:Create an Alchemy App 

To use Alchemy's products, you need an API key to authenticate your requests.

You can create API keys [from the dashboard](https://cro-dashboard.alchemyapi.io/). To make a new key, click on the "Create App" button circled below:

![](https://1879738505-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MR6M26d7HiK3wpCRH-V%2F-MRDuX8Ho47kexnG18oL%2F-MRE1dLsj_BxbMFmTVno%2FScreen%20Shot%202021-01-16%20at%2010.30.32%20PM.png?alt=media\&token=2cdfe9fd-f9d1-4c48-a8be-c992208eb929)

Fill in the details under "Create App" to get your new key. There are two options for networks: Mainnet and Croeseid (the API methods for both are the same). 

![](https://1879738505-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MR6M26d7HiK3wpCRH-V%2F-MW_IjgGeQFZ0uZUHsnx%2F-MW_XaT-fjpKLZJyHS_i%2FScreen%20Shot%202021-03-24%20at%2011.41.08%20AM.png?alt=media\&token=a4a43310-04a5-4afd-893e-ee186760f03a)

At anytime, you can visit your [dashboard homepage](https://cro-dashboard.alchemyapi.io/) and view your app's keys by clicking the key icon on the far right.

![](https://1879738505-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MR6M26d7HiK3wpCRH-V%2F-MRDuX8Ho47kexnG18oL%2F-MRE2-bSIv7d5IgOAVeO%2FScreen%20Shot%202021-01-16%20at%2010.32.58%20PM.png?alt=media\&token=7830f732-77b9-4675-985d-c11e28e2105b)

## 2.:writing\_hand:Make a Request 

You can interact with Alchemy's Crypto.org API through [Tendermint](https://cro-docs.alchemy.com/documentation/tendermint) or [gRPC](https://cro-docs.alchemy.com/documentation/grpc).

{% hint style="info" %}
**NOTE: Tendermint has two forms of RPC protocols:**

1. **URI/HTTP**: a REST like interface 
2. **JSONRPC/HTTP:** can be POST'd to the root RPC endpoint via HTTP.
   {% endhint %}

Here is an example you can run from the command line to retrieve the block at height 1:

#### Tendermint

{% tabs %}
{% tab title="URI" %}

```bash
curl cro-croeseid.alchemyapi.io/your-api-key/tendermint/block?height=1
```

{% endtab %}

{% tab title="JSON-RPC" %}

```
curl --header "Content-Type: application/json" --request POST --data '{"method": "block", "params": ["1"], "id": 1}' cro-croeseid.alchemyapi.io/your-api-key/tendermint
```

{% endtab %}
{% endtabs %}

#### gRPC

```javascript
curl cro-croeseid.alchemyapi.io/your-api-key/grpc-reset/blocks/1
```

{% hint style="warning" %}
We've created an API key called **`your-api-key`** so you can easily copy, paste, and test these sample requests. However, you should replace `your-api-key` with your actual unique API key when developing. 
{% endhint %}

Results:

```javascript
{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
    "block_id": {
      "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
      "parts": {
        "total": 1,
        "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
      }
    },
    "block": {
      "header": {
        "version": {
          "block": "10",
          "app": "0"
        },
        "chain_id": "cosmoshub-2",
        "height": "12",
        "time": "2019-04-22T17:01:51.701356223Z",
        "last_block_id": {
          "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
          "parts": {
            "total": 1,
            "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
          }
        },
        "last_commit_hash": "21B9BC845AD2CB2C4193CDD17BFC506F1EBE5A7402E84AD96E64171287A34812",
        "data_hash": "970886F99E77ED0D60DA8FCE0447C2676E59F2F77302B0C4AA10E1D02F18EF73",
        "validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
        "next_validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
        "consensus_hash": "0F2908883A105C793B74495EB7D6DF2EEA479ED7FC9349206A65CB0F9987A0B8",
        "app_hash": "223BF64D4A01074DC523A80E76B9BBC786C791FB0A1893AC5B14866356FCFD6C",
        "last_results_hash": "",
        "evidence_hash": "",
        "proposer_address": "D540AB022088612AC74B287D076DBFBC4A377A2E"
      },
      "data": [
        "yQHwYl3uCkKoo2GaChRnd+THLQ2RM87nEZrE19910Z28ABIUWW/t8AtIMwcyU0sT32RcMDI9GF0aEAoFdWF0b20SBzEwMDAwMDASEwoNCgV1YXRvbRIEMzEwMRCd8gEaagom61rphyEDoJPxlcjRoNDtZ9xMdvs+lRzFaHe2dl2P5R2yVCWrsHISQKkqX5H1zXAIJuC57yw0Yb03Fwy75VRip0ZBtLiYsUqkOsPUoQZAhDNP+6LY+RUwz/nVzedkF0S29NZ32QXdGv0="
      ],
      "evidence": [
        {
          "type": "string",
          "height": 0,
          "time": 0,
          "total_voting_power": 0,
          "validator": {
            "pub_key": {
              "type": "tendermint/PubKeyEd25519",
              "value": "A6DoBUypNtUAyEHWtQ9bFjfNg8Bo9CrnkUGl6k6OHN4="
            },
            "voting_power": 0,
            "address": "string"
          }
        }
      ],
      "last_commit": {
        "height": 0,
        "round": 0,
        "block_id": {
          "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
          "parts": {
            "total": 1,
            "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
          }
        },
        "signatures": [
          {
            "type": 2,
            "height": "1262085",
            "round": 0,
            "block_id": {
              "hash": "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7",
              "parts": {
                "total": 1,
                "hash": "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD"
              }
            },
            "timestamp": "2019-08-01T11:39:38.867269833Z",
            "validator_address": "000001E443FD237E4B616E2FA69DF4EE3D49A94F",
            "validator_index": 0,
            "signature": "DBchvucTzAUEJnGYpNvMdqLhBAHG4Px8BsOBB3J3mAFCLGeuG7uJqy+nVngKzZdPhPi8RhmE/xcw/M9DOJjEDg=="
          }
        ]
      }
    }
  }
}
```