> For the complete documentation index, see [llms.txt](https://comet-3.gitbook.io/comet-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://comet-3.gitbook.io/comet-sdk/reference/comet-sdk-reference/comet-rest-api.md).

# 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="/pages/ThjFFrxDNpCvnx1gWJzq" %}
[Collections](/comet-sdk/reference/comet-sdk-reference/comet-rest-api/collections.md)
{% 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="/pages/WJTCJZq912wf4JNUUQoI" %}
[Airdrops](/comet-sdk/reference/comet-sdk-reference/comet-rest-api/airdrops.md)
{% endcontent-ref %}

### Gallery

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

{% content-ref url="/pages/ibREthSg5LaxpBr6XMdZ" %}
[Gallery](/comet-sdk/reference/comet-sdk-reference/comet-rest-api/gallery.md)
{% endcontent-ref %}

### Usage

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

{% content-ref url="/pages/LSfoiVPKdP5nELZVbSb8" %}
[Usage](/comet-sdk/reference/comet-sdk-reference/comet-rest-api/usage.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://comet-3.gitbook.io/comet-sdk/reference/comet-sdk-reference/comet-rest-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.