Skip to main content

Security and Permission Types

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

Security Types

Security types define the authentication required to access API endpoints.

Security TypeDescription
NONEEndpoint can be accessed freely
SIGNEDRequires a valid APIKey and a Signature for access

Permission Types

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.

Permission TypeDescription
NONEEndpoint can be accessed freely
BOTS_READAllows viewing information associated with this permission
BOTS_WRITEAllows creating or modifying data associated with this permission
ACCOUNTS_READAllows viewing information associated with this permission
ACCOUNTS_WRITEAllows creating or modifying data associated with this permission
SMART_TRADES_READAllows viewing information associated with this permission
SMART_TRADES_WRITEAllows creating or modifying data associated with this permission