# Getting Started

## 📋 Overview&#x20;

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&#x20;

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:

![](/files/-MRE1dLsj_BxbMFmTVno)

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).&#x20;

![](/files/-MW_XaT-fjpKLZJyHS_i)

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.

![](/files/-MRE2-bSIv7d5IgOAVeO)

## 2.:writing\_hand:Make a Request&#x20;

You can interact with Alchemy's Crypto.org API through [Tendermint](/documentation/tendermint.md) or [gRPC](/documentation/grpc.md).

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

1. **URI/HTTP**: a REST like interface&#x20;
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.&#x20;
{% 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=="
          }
        ]
      }
    }
  }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cro-docs.alchemy.com/guides/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
