> 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/account.md).

# Account

**Account** entities hold information about the cryptocurrency portfolio, theys balances and the set of tools that are available for this account.\ <br>

**Account** entities hold information like:

* Details about the connected exchange, including its type, name, and current status;<br>
* Profit and currency information, such as the account's balance and daily and total profit;<br>
* Available trading features for this account.\ <br>

3Commas provides a set of methods to create new exchange account connections and manage existing accounts.\ <br>

## Attributes<br>

**id**     `integer`\
ID of the exchange account entity

**name**     `string`\
The name for the exchange account set by the user

**exchange\_name**     `string`\
Name of this exchange account

**market\_icon**     `string`\
Icon of the exchange

**market\_code**     `string`\
3Commas of exchange code entity

**autobalance\_enabled**     `boolean`\
Indicates whether auto-balance mode is enabled for this account

**auto\_balance\_period**     `null` or `string`\
The interval, in hours, at which automatic portfolio balancing occurs

**auto\_balance\_portfolio\_id**      `integer` or `null`\
ID of the portfolio for which automatic balancing has been initiated

**autobalance\_enabled**     `boolean`\
Indicates whether auto-balance mode is enabled for this account

**auto\_balance\_error**     `string` or `null`\
A description comes up to explain why auto-balance failed

**last\_auto\_balance**     `null` or `string`\
ISO 8601 datetime `string` of when this auto-balance was last time

**hedge\_mode\_available**     `boolean`\
Indicates whether hedge mode is available for this account

**hedge\_mode\_enabled**     `boolean`\
Indicates whether hedge mode is enabled for this account

**is\_locked**     `boolean`\
Indicates if the account is locked

**lock\_reason**     `null` or `string`\
The reason for locking this account in case `is_locked` is `true`

**smart\_trading\_supported**     `boolean`\
Indicates if smart trading is supported

**stats\_supported**     `boolean`\
Indicates whether statistic of profit are supported for this account

**trading\_supported**     `boolean`\
Indicates if trading is supported at 3Commas

**market\_buy\_supported**     `boolean`\
Indicates whether creating a market buy order is supported on the exchange

**market\_sell\_supported**     `boolean`\
Indicates whether creating a market sell order is supported on the exchange

**conditional\_buy\_supported**     `boolean`\
Indicates whether creating a conditional buy order is supported on the exchange

**bots\_allowed**     `boolean`\
Indicates whether DCA Bot is enabled for this account

**bots\_ttp\_allowed**     `boolean` Indicates whether the trailing take profit feature is enabled on this account

**bots\_tsl\_allowed**     `boolean`\
Indicates whether the trading stop loss feature is enabled on this account

**multi\_bots\_allowed**     `boolean`\
Indicates whether the Multi-Pair feature is supported for this account

**fast\_convert\_available**     `boolean`\
Indicates whether the "Sell All to BTC/USD" feature is enabled for this account<br>

**grid\_bots\_allowed**     `boolean`\
Indicates whether Grid Bot is enabled for this account

**api\_key**     `string`\
API key used for the account

**api\_key\_invalid**     `boolean`\
Indicates whether the API key for this account is invalid

**api\_keys\_state**     `string`\
Indicates the state of the API keys

**deposit\_enabled**     `boolean`\
Indicates whether the Deposit feature is enabled for this account

**available\_include\_in\_summary**     `boolean`\
Indicates whether this account is available to be included in the summary

**include\_in\_summary**     `boolean`\
Indicates whether this account included in the summary

**supported\_market\_types**     `array`\
The type of market supported by the connected exchange account

**customer\_id**      `string`\
Unique customer ID provided by the Bitstamp exchange

**btc\_amount**     `string`\
Amount of Bitcoin in the account

**usd\_amount**     `string`\
Amount in USD in the account

**day\_profit\_etc**     `string`\
Daily profit in BTC

**day\_profit\_usd**     `string`\
Daily profit in USD

**day\_profit\_btc\_percentage**     `number`\
Daily profit percentage in BTC<br>

**day\_profit\_usd\_percentage**     `number`\
Daily profit percentage in USD

**btc\_profit**     `number`\
Monthly profit in BTC

**usd\_profit**      `number`\
Monthly profit in USD

**btc\_profit\_percentage**      `number`\
Monthly profit percentage in BTC

**usd\_profit\_percentage**      `number`\
Monthly profit percentage in USD

**total\_btc\_profit**      `number`\
Total profit in BTC

**total\_usd\_profit**     `number`\
Total profit in USD

**created\_at**     `string`\
ISO 8601 datetime string of when this Account entity was created

**updated\_at**     `string`\
ISO 8601 datetime string of when this SmartTrade entity was updated