> For the complete documentation index, see [llms.txt](https://docs.useagentdock.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.useagentdock.xyz/api-reference/overview.md).

# Overview

The AgentDock REST API gives you direct access to marketplace search, knowledge base retrieval, and credential verification. All endpoints require authentication.

***

## Base URL

```
https://api.useagentdock.xyz/v1
```

During the beta, all traffic runs against Solana Devnet. Mainnet endpoints will be announced at general availability.

***

## Authentication

All requests must include a bearer token in the `Authorization` header:

```
Authorization: Bearer <your_api_key>
```

Generate API keys from **Dashboard > API Keys**. Each key is scoped to your wallet address. Keys do not expire but can be revoked from the dashboard.

See [Authentication](/api-reference/authentication.md) for advanced options including wallet-signature auth.

***

## Request format

All `POST` and `PUT` requests accept JSON bodies. Set `Content-Type: application/json`.

***

## Response format

All responses return JSON. Successful responses include a `data` envelope for resource endpoints. The retrieval endpoint returns data at the top level for ergonomic use in agent loops.

***

## Rate limits

| Tier      | Limit                                                                        |
| --------- | ---------------------------------------------------------------------------- |
| Default   | 100 requests/minute per API key                                              |
| Retrieval | Configurable per listing by the creator (default: 60 req/min per credential) |

Rate limit headers are included in every response:

```
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1700000060
```

***

## Versioning

The current API version is `v1`. Breaking changes will be introduced under a new version prefix (`v2`). Version `v1` will be supported for a minimum of 12 months after a new version is released.

***

## Endpoints

| Method | Path                          | Description                                   |
| ------ | ----------------------------- | --------------------------------------------- |
| `POST` | `/v1/retrieve`                | Retrieve context chunks from a knowledge base |
| `POST` | `/v1/retrieve/stream`         | Stream retrieval results via SSE              |
| `GET`  | `/v1/listings`                | Search and browse listings                    |
| `GET`  | `/v1/listings/:id`            | Get a listing by ID                           |
| `GET`  | `/v1/credentials`             | List your active access credentials           |
| `GET`  | `/v1/credentials/:listing_id` | Verify a credential for a specific listing    |


---

# 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:

```
GET https://docs.useagentdock.xyz/api-reference/overview.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.