# Postman Collection

## Ortege API Postman Collection Documentation

The [**Ortege API Postman Collection**](https://github.com/Ortege-xyz/postman) provides developers with a convenient way to explore and interact with the Ortege API. This collection includes pre-built requests for accessing blockchain data across REST, GraphQL, and WebSocket endpoints. By using this collection, you can quickly test queries, explore data structures, and integrate Ortege’s powerful datasets into your applications.

***

### 1. Getting Started

#### Prerequisites

To get started with the Ortege API Postman Collection, you’ll need:

1. [**Postman**](https://www.postman.com/downloads/): Download and install Postman from here.
2. **JWT Token**: Obtain a JWT token from the Ortege team for secure API access.

#### Importing the Collection

1. Download the Ortege API Postman Collection JSON file from the [Github Repository.](https://github.com/Ortege-xyz/postman)
2. In Postman, go to **File > Import**, choose the JSON file, and import it.

#### Setting Up the Environment

Creating an environment allows you to manage variables like your JWT token and the base API URL, making it easy to switch environments or update configurations.

1. In Postman, go to **Environments** > **+ New Environment**.
2. Name your environment (e.g., “Ortege API”).
3. Add the following variables:
   * **`jwt_token`**: Enter your JWT token value here.
   * **`base_url_rest`**: Set this to `https://api-staging.ortege.ai/cubejs-api/v1` for REST

#### Configuring Authorization

1. Open the imported collection.
2. Go to the **Authorization** tab of the collection.
3. Select **Bearer Token** as the authorization type.
4. Set the **Token** field to `{{jwt_token}}` to link to your environment variable.

***

### 2. Troubleshooting Common Issues

* **401 Unauthorized Error**: Verify your JWT token is correct and included in the `jwt_token` variable within your environment.
* **Query Syntax Errors**: Check the structure of your query against the [**Query Syntax Documentation**](/en/ortege-products/api/query-syntax.md) to ensure it’s valid for the API endpoint.


---

# 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://docs.ortege.ai/en/ortege-products/api/postman-collection.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.
