# Comet REST API

With Comet's REST API, you can launch new NFT collections, distribute them quickly to your users, and see who owns what. Never worry about RPC nodes again – just get a Comet developer API key and start hacking!

{% hint style="info" %}
Comet is currently on version 1 of the REST API. The base URL for all requests is `https://api.withcomet.com/v1/`.
{% endhint %}

{% hint style="info" %}
Unless specified otherwise, all API endpoints accept a `Content-Type` of `application/json`.
{% endhint %}

## Comet Node SDK

Comet has a Node.js wrapper for the REST API here: <https://www.npmjs.com/package/@comet-labs/node>.

### Collections

With the `/collection` endpoints, you can query existing NFT collections or launch new ones.

{% content-ref url="comet-rest-api/collections" %}
[collections](https://comet-3.gitbook.io/comet-sdk/reference/comet-sdk-reference/comet-rest-api/collections)
{% endcontent-ref %}

### Airdrops

Once you've launched a new collection, start giving it out to your users! The `/airdrop` endpoints give fine-grained control over who receives which tokens.

{% content-ref url="comet-rest-api/airdrops" %}
[airdrops](https://comet-3.gitbook.io/comet-sdk/reference/comet-sdk-reference/comet-rest-api/airdrops)
{% endcontent-ref %}

### Gallery

With the `/gallery` endpoint, you can see which tokens any address or Comet user owns.

{% content-ref url="comet-rest-api/gallery" %}
[gallery](https://comet-3.gitbook.io/comet-sdk/reference/comet-sdk-reference/comet-rest-api/gallery)
{% endcontent-ref %}

### Usage

Quickly view your API usage with the `/usage` endpoint.

{% content-ref url="comet-rest-api/usage" %}
[usage](https://comet-3.gitbook.io/comet-sdk/reference/comet-sdk-reference/comet-rest-api/usage)
{% endcontent-ref %}


---

# 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://comet-3.gitbook.io/comet-sdk/reference/comet-sdk-reference/comet-rest-api.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.