> For the complete documentation index, see [llms.txt](https://3commas.gitbook.io/3commas-official-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3commas.gitbook.io/3commas-official-api-docs/general-information/security-and-permission-types.md).

# Security and Permission Types

<br>

Each endpoint in the 3Commas API has specific security and permission types, which determine how you can interact with it.

## Security Types<br>

Security types define the authentication required to access API endpoints.

| Security Type | Description                                            |
| ------------- | ------------------------------------------------------ |
| NONE          | Endpoint can be accessed freely                        |
| SIGNED        | Requires a valid `APIKey` and a `Signature` for access |

<br>

## Permission Types<br>

Each API endpoint has a specific permission type that defines how it can be accessed.

Also the 3Commas API allows configuring API Keys with different permission sets.\
For example, one API Key might provide access to read-only statistics, while another could enable full control over bots and accounts.

<br>

| Permission Type      | Description                                                       |
| -------------------- | ----------------------------------------------------------------- |
| NONE                 | Endpoint can be accessed freely                                   |
| BOTS\_READ           | Allows viewing information associated with this permission        |
| BOTS\_WRITE          | Allows creating or modifying data associated with this permission |
| ACCOUNTS\_READ       | Allows viewing information associated with this permission        |
| ACCOUNTS\_WRITE      | Allows creating or modifying data associated with this permission |
| SMART\_TRADES\_READ  | Allows viewing information associated with this permission        |
| SMART\_TRADES\_WRITE | Allows creating or modifying data associated with this permission |
