# Accounts
Trading and consumption accounts, their balances and more.
## List consumption accounts
> View your consumption accounts by instrument, including balances and tokens used.
```json
{"openapi":"3.0.3","info":{"title":"Trading API","version":"1.0.0"},"tags":[{"name":"Accounts","description":"Trading and consumption accounts, their balances and more.\n"}],"servers":[{"url":"{BASE_URL}/v1","description":"GRID Trading API Base URL\n","variables":{"BASE_URL":{"default":"https://trading.api.thegrid.ai","description":"The base URL for the API.\n"}}}],"security":[{"signatureAuth":[]}],"components":{"securitySchemes":{"signatureAuth":{"type":"apiKey","in":"header","name":"x-thegrid-signature","description":"Ed25519 signature authentication. **All three headers are required** for every request:\n\n| Header | Description |\n|--------|-------------|\n| `x-thegrid-signature` | Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`\n| `x-thegrid-timestamp` | Unix timestamp in seconds (must be within 30 seconds of server time) |\n| `x-thegrid-fingerprint` | SHA256 hash of your public key (Base64-encoded, padding stripped) |\n\n[See full authentication docs](./overview-trading-api/authentication)\n"}},"parameters":{"next":{"name":"next","in":"query","schema":{"type":"string"},"description":"Cursor for forward pagination. Pass the `next_cursor` value from a previous response to fetch the next page. Mutually exclusive with `prev`.\n"},"prev":{"name":"prev","in":"query","schema":{"type":"string"},"description":"Cursor for backward pagination. Pass the `prev_cursor` value from a previous response to fetch the previous page. Mutually exclusive with `next`.\n"},"limit":{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100},"description":"Number of items to return per page (max: 100)\n"}},"schemas":{"ConsumptionAccountsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ConsumptionAccount"}},"paging":{"$ref":"#/components/schemas/CursorPaging"}}},"ConsumptionAccount":{"type":"object","properties":{"account_id":{"type":"string"},"user_id":{"type":"string"},"instrument_id":{"type":"string"},"total_balance":{"type":"integer","description":"Total token balance in the account.\n"},"committed_balance":{"type":"integer","description":"Tokens currently reserved for a consumption request. Unused tokens will be returned after the request is fulfilled.\n"},"uncommitted_balance":{"type":"integer","description":"Tokens currently uncommitted (available for new requests).\n"},"tokens_allocated":{"type":"integer","description":"Total tokens allocated to this consumption account across all time.\n"},"tokens_available":{"type":"integer","description":"Tokens currently available for consumption after commitments.\n"},"status":{"type":"string","enum":["active","inactive"]},"total_commitments":{"type":"integer","description":"Total number of commitments made from this account.\n"},"total_deposits":{"type":"integer","description":"Total number of deposits into this account.\n"},"total_transfers_in":{"type":"integer","description":"Total number of transfers into the account.\n"},"total_transfers_out":{"type":"integer","description":"Total number of transfers out of the account.\n"},"total_withdrawals":{"type":"integer","description":"Total number of withdrawals from the account.\n"},"last_commitment_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last commitment (null if none)\n"},"last_deposit_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last deposit (null if none)\n"},"last_transfer_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last transfer (null if none)\n"},"last_withdrawal_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last withdrawal (null if none)\n"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"CursorPaging":{"type":"object","description":"Cursor-based pagination\n","properties":{"has_more":{"type":"boolean"},"next_cursor":{"type":"string","nullable":true},"prev_cursor":{"type":"string","nullable":true}}}}},"paths":{"/consumption-accounts":{"get":{"tags":["Accounts"],"summary":"List consumption accounts","description":"View your consumption accounts by instrument, including balances and tokens used.\n","operationId":"listConsumptionAccounts","parameters":[{"name":"account_id","in":"query","schema":{"type":"string"},"description":"Filter by account ID"},{"name":"instrument_id","in":"query","schema":{"type":"string"},"description":"Filter by instrument ID"},{"name":"status","in":"query","schema":{"type":"string","enum":["active","inactive"]},"description":"Filter by account status"},{"name":"order_by","in":"query","schema":{"type":"string","enum":["account_id","total_balance","committed_balance","uncommitted_balance","status","created_at","updated_at"]},"description":"Field to sort by"},{"name":"order_direction","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"description":"Sort direction"},{"$ref":"#/components/parameters/next"},{"$ref":"#/components/parameters/prev"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"Consumption accounts\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsumptionAccountsResponse"}}}}}}}}}
```
## Get consumption account details
> Get detailed information about a specific consumption account.
```json
{"openapi":"3.0.3","info":{"title":"Trading API","version":"1.0.0"},"tags":[{"name":"Accounts","description":"Trading and consumption accounts, their balances and more.\n"}],"servers":[{"url":"{BASE_URL}/v1","description":"GRID Trading API Base URL\n","variables":{"BASE_URL":{"default":"https://trading.api.thegrid.ai","description":"The base URL for the API.\n"}}}],"security":[{"signatureAuth":[]}],"components":{"securitySchemes":{"signatureAuth":{"type":"apiKey","in":"header","name":"x-thegrid-signature","description":"Ed25519 signature authentication. **All three headers are required** for every request:\n\n| Header | Description |\n|--------|-------------|\n| `x-thegrid-signature` | Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`\n| `x-thegrid-timestamp` | Unix timestamp in seconds (must be within 30 seconds of server time) |\n| `x-thegrid-fingerprint` | SHA256 hash of your public key (Base64-encoded, padding stripped) |\n\n[See full authentication docs](./overview-trading-api/authentication)\n"}},"schemas":{"ConsumptionAccount":{"type":"object","properties":{"account_id":{"type":"string"},"user_id":{"type":"string"},"instrument_id":{"type":"string"},"total_balance":{"type":"integer","description":"Total token balance in the account.\n"},"committed_balance":{"type":"integer","description":"Tokens currently reserved for a consumption request. Unused tokens will be returned after the request is fulfilled.\n"},"uncommitted_balance":{"type":"integer","description":"Tokens currently uncommitted (available for new requests).\n"},"tokens_allocated":{"type":"integer","description":"Total tokens allocated to this consumption account across all time.\n"},"tokens_available":{"type":"integer","description":"Tokens currently available for consumption after commitments.\n"},"status":{"type":"string","enum":["active","inactive"]},"total_commitments":{"type":"integer","description":"Total number of commitments made from this account.\n"},"total_deposits":{"type":"integer","description":"Total number of deposits into this account.\n"},"total_transfers_in":{"type":"integer","description":"Total number of transfers into the account.\n"},"total_transfers_out":{"type":"integer","description":"Total number of transfers out of the account.\n"},"total_withdrawals":{"type":"integer","description":"Total number of withdrawals from the account.\n"},"last_commitment_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last commitment (null if none)\n"},"last_deposit_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last deposit (null if none)\n"},"last_transfer_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last transfer (null if none)\n"},"last_withdrawal_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last withdrawal (null if none)\n"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"data":{"description":"Optional payload for non-error responses (typically null on errors)","nullable":true},"error":{"type":"string","nullable":true,"description":"Short, human-readable error summary"},"errors":{"type":"object","description":"Machine-readable error details","properties":{"detail":{"type":"string","description":"High-level error detail message"},"fields":{"type":"object","description":"Per-field validation errors when applicable"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (for rate limit errors)"}}},"meta":{"type":"object","description":"Optional metadata about the error (e.g., request_id, timestamp)"}}}},"responses":{"NotFound":{"description":"Not found - The requested resource does not exist\n","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/consumption-accounts/{account_id}":{"get":{"tags":["Accounts"],"summary":"Get consumption account details","description":"Get detailed information about a specific consumption account.\n","operationId":"tradingGetConsumptionAccount","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the consumption account (e.g., \"consumption_account_cbf73393ef9e2ed0\")\n"}],"responses":{"200":{"description":"Consumption account details\n","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ConsumptionAccount"}}}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```
## List currency trading accounts
> List all currency trading accounts (USD, etc.).
```json
{"openapi":"3.0.3","info":{"title":"Trading API","version":"1.0.0"},"tags":[{"name":"Accounts","description":"Trading and consumption accounts, their balances and more.\n"}],"servers":[{"url":"{BASE_URL}/v1","description":"GRID Trading API Base URL\n","variables":{"BASE_URL":{"default":"https://trading.api.thegrid.ai","description":"The base URL for the API.\n"}}}],"security":[{"signatureAuth":[]}],"components":{"securitySchemes":{"signatureAuth":{"type":"apiKey","in":"header","name":"x-thegrid-signature","description":"Ed25519 signature authentication. **All three headers are required** for every request:\n\n| Header | Description |\n|--------|-------------|\n| `x-thegrid-signature` | Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`\n| `x-thegrid-timestamp` | Unix timestamp in seconds (must be within 30 seconds of server time) |\n| `x-thegrid-fingerprint` | SHA256 hash of your public key (Base64-encoded, padding stripped) |\n\n[See full authentication docs](./overview-trading-api/authentication)\n"}},"parameters":{"next":{"name":"next","in":"query","schema":{"type":"string"},"description":"Cursor for forward pagination. Pass the `next_cursor` value from a previous response to fetch the next page. Mutually exclusive with `prev`.\n"},"prev":{"name":"prev","in":"query","schema":{"type":"string"},"description":"Cursor for backward pagination. Pass the `prev_cursor` value from a previous response to fetch the previous page. Mutually exclusive with `next`.\n"},"limit":{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100},"description":"Number of items to return per page (max: 100)\n"}},"schemas":{"CurrencyTradingAccount":{"type":"object","properties":{"account_id":{"type":"string"},"user_id":{"type":"string"},"currency":{"type":"string"},"total_balance":{"type":"string"},"available_balance":{"type":"string"},"locked_balance":{"type":"string"},"status":{"type":"string"},"last_deposit_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last deposit (null if none)\n"},"last_trading_activity_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last trading activity (null if none)\n"},"last_withdrawal_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last withdrawal (null if none)\n"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"CursorPaging":{"type":"object","description":"Cursor-based pagination\n","properties":{"has_more":{"type":"boolean"},"next_cursor":{"type":"string","nullable":true},"prev_cursor":{"type":"string","nullable":true}}}}},"paths":{"/currency-trading-accounts":{"get":{"tags":["Accounts"],"summary":"List currency trading accounts","description":"List all currency trading accounts (USD, etc.).\n","operationId":"tradingListCurrencyAccounts","parameters":[{"name":"user_id","in":"query","schema":{"type":"string"},"description":"Filter by user ID"},{"name":"account_id","in":"query","schema":{"type":"string"},"description":"Filter by account ID"},{"name":"currency","in":"query","schema":{"type":"string"},"description":"Filter by currency (e.g., \"USD\")"},{"name":"status","in":"query","schema":{"type":"string","enum":["active","inactive"]},"description":"Filter by account status"},{"name":"order_by","in":"query","schema":{"type":"string","enum":["account_id","currency","total_balance","available_balance","status","created_at","updated_at"]},"description":"Field to sort by"},{"name":"order_direction","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"description":"Sort direction"},{"$ref":"#/components/parameters/next"},{"$ref":"#/components/parameters/prev"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"List of currency trading accounts\n","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyTradingAccount"}},"paging":{"$ref":"#/components/schemas/CursorPaging"}}}}}}}}}}}
```
## Get currency account details
> Get specific currency trading account details.
```json
{"openapi":"3.0.3","info":{"title":"Trading API","version":"1.0.0"},"tags":[{"name":"Accounts","description":"Trading and consumption accounts, their balances and more.\n"}],"servers":[{"url":"{BASE_URL}/v1","description":"GRID Trading API Base URL\n","variables":{"BASE_URL":{"default":"https://trading.api.thegrid.ai","description":"The base URL for the API.\n"}}}],"security":[{"signatureAuth":[]}],"components":{"securitySchemes":{"signatureAuth":{"type":"apiKey","in":"header","name":"x-thegrid-signature","description":"Ed25519 signature authentication. **All three headers are required** for every request:\n\n| Header | Description |\n|--------|-------------|\n| `x-thegrid-signature` | Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`\n| `x-thegrid-timestamp` | Unix timestamp in seconds (must be within 30 seconds of server time) |\n| `x-thegrid-fingerprint` | SHA256 hash of your public key (Base64-encoded, padding stripped) |\n\n[See full authentication docs](./overview-trading-api/authentication)\n"}},"schemas":{"CurrencyTradingAccount":{"type":"object","properties":{"account_id":{"type":"string"},"user_id":{"type":"string"},"currency":{"type":"string"},"total_balance":{"type":"string"},"available_balance":{"type":"string"},"locked_balance":{"type":"string"},"status":{"type":"string"},"last_deposit_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last deposit (null if none)\n"},"last_trading_activity_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last trading activity (null if none)\n"},"last_withdrawal_at":{"type":"string","format":"date-time","nullable":true,"description":"Timestamp of last withdrawal (null if none)\n"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"data":{"description":"Optional payload for non-error responses (typically null on errors)","nullable":true},"error":{"type":"string","nullable":true,"description":"Short, human-readable error summary"},"errors":{"type":"object","description":"Machine-readable error details","properties":{"detail":{"type":"string","description":"High-level error detail message"},"fields":{"type":"object","description":"Per-field validation errors when applicable"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (for rate limit errors)"}}},"meta":{"type":"object","description":"Optional metadata about the error (e.g., request_id, timestamp)"}}}},"responses":{"NotFound":{"description":"Not found - The requested resource does not exist\n","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/currency-trading-accounts/{account_id}":{"get":{"tags":["Accounts"],"summary":"Get currency account details","description":"Get specific currency trading account details.\n","operationId":"tradingGetCurrencyAccount","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the currency trading account (e.g., \"currency_trading_account_57252e83c212e7a9\")\n"}],"responses":{"200":{"description":"Currency account details\n","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CurrencyTradingAccount"}}}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```
## List trading account balances
> List all trading account balances across instruments.
```json
{"openapi":"3.0.3","info":{"title":"Trading API","version":"1.0.0"},"tags":[{"name":"Accounts","description":"Trading and consumption accounts, their balances and more.\n"}],"servers":[{"url":"{BASE_URL}/v1","description":"GRID Trading API Base URL\n","variables":{"BASE_URL":{"default":"https://trading.api.thegrid.ai","description":"The base URL for the API.\n"}}}],"security":[{"signatureAuth":[]}],"components":{"securitySchemes":{"signatureAuth":{"type":"apiKey","in":"header","name":"x-thegrid-signature","description":"Ed25519 signature authentication. **All three headers are required** for every request:\n\n| Header | Description |\n|--------|-------------|\n| `x-thegrid-signature` | Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`\n| `x-thegrid-timestamp` | Unix timestamp in seconds (must be within 30 seconds of server time) |\n| `x-thegrid-fingerprint` | SHA256 hash of your public key (Base64-encoded, padding stripped) |\n\n[See full authentication docs](./overview-trading-api/authentication)\n"}},"parameters":{"next":{"name":"next","in":"query","schema":{"type":"string"},"description":"Cursor for forward pagination. Pass the `next_cursor` value from a previous response to fetch the next page. Mutually exclusive with `prev`.\n"},"prev":{"name":"prev","in":"query","schema":{"type":"string"},"description":"Cursor for backward pagination. Pass the `prev_cursor` value from a previous response to fetch the previous page. Mutually exclusive with `next`.\n"},"limit":{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100},"description":"Number of items to return per page (max: 100)\n"}},"schemas":{"TradingAccount":{"type":"object","properties":{"account_id":{"type":"string"},"user_id":{"type":"string"},"instrument_id":{"type":"string"},"instrument_name":{"type":"string"},"instrument_symbol":{"type":"string"},"market_id":{"type":"string"},"market_name":{"type":"string"},"total_balance":{"type":"string","description":"Sum of available and locked balances (decimal string)\n"},"available_balance":{"type":"string","description":"Balance available for placing new orders (decimal string)\n"},"locked_balance":{"type":"string","description":"Balance currently locked in open orders (decimal string)\n"},"last_trade_price":{"type":"string","nullable":true},"status":{"type":"string","enum":["active","inactive"]},"last_deposit_at":{"type":"string","format":"date-time","nullable":true},"last_trading_activity_at":{"type":"string","format":"date-time","nullable":true},"last_withdrawal_at":{"type":"string","format":"date-time","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"CursorPaging":{"type":"object","description":"Cursor-based pagination\n","properties":{"has_more":{"type":"boolean"},"next_cursor":{"type":"string","nullable":true},"prev_cursor":{"type":"string","nullable":true}}}}},"paths":{"/trading-accounts":{"get":{"tags":["Accounts"],"summary":"List trading account balances","description":"List all trading account balances across instruments.\n","operationId":"tradingListTradingAccounts","parameters":[{"name":"account_id","in":"query","schema":{"type":"string"},"description":"Filter by account ID"},{"name":"market_id","in":"query","schema":{"type":"string"},"description":"Filter by market ID"},{"name":"instrument_id","in":"query","schema":{"type":"string"},"description":"Filter by instrument ID"},{"name":"status","in":"query","schema":{"type":"string","enum":["active","inactive"]},"description":"Filter by account status"},{"name":"order_by","in":"query","schema":{"type":"string","enum":["account_id","total_balance","available_balance","status","created_at","updated_at"]},"description":"Field to sort by"},{"name":"order_direction","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"description":"Sort direction"},{"$ref":"#/components/parameters/next"},{"$ref":"#/components/parameters/prev"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"List of trading accounts\n","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TradingAccount"}},"paging":{"$ref":"#/components/schemas/CursorPaging"}}}}}}}}}}}
```
## Get trading account details
> Get detailed information about a specific trading account.
```json
{"openapi":"3.0.3","info":{"title":"Trading API","version":"1.0.0"},"tags":[{"name":"Accounts","description":"Trading and consumption accounts, their balances and more.\n"}],"servers":[{"url":"{BASE_URL}/v1","description":"GRID Trading API Base URL\n","variables":{"BASE_URL":{"default":"https://trading.api.thegrid.ai","description":"The base URL for the API.\n"}}}],"security":[{"signatureAuth":[]}],"components":{"securitySchemes":{"signatureAuth":{"type":"apiKey","in":"header","name":"x-thegrid-signature","description":"Ed25519 signature authentication. **All three headers are required** for every request:\n\n| Header | Description |\n|--------|-------------|\n| `x-thegrid-signature` | Base64-encoded Ed25519 signature of `{timestamp}{METHOD}{path}{body}`\n| `x-thegrid-timestamp` | Unix timestamp in seconds (must be within 30 seconds of server time) |\n| `x-thegrid-fingerprint` | SHA256 hash of your public key (Base64-encoded, padding stripped) |\n\n[See full authentication docs](./overview-trading-api/authentication)\n"}},"schemas":{"TradingAccount":{"type":"object","properties":{"account_id":{"type":"string"},"user_id":{"type":"string"},"instrument_id":{"type":"string"},"instrument_name":{"type":"string"},"instrument_symbol":{"type":"string"},"market_id":{"type":"string"},"market_name":{"type":"string"},"total_balance":{"type":"string","description":"Sum of available and locked balances (decimal string)\n"},"available_balance":{"type":"string","description":"Balance available for placing new orders (decimal string)\n"},"locked_balance":{"type":"string","description":"Balance currently locked in open orders (decimal string)\n"},"last_trade_price":{"type":"string","nullable":true},"status":{"type":"string","enum":["active","inactive"]},"last_deposit_at":{"type":"string","format":"date-time","nullable":true},"last_trading_activity_at":{"type":"string","format":"date-time","nullable":true},"last_withdrawal_at":{"type":"string","format":"date-time","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"data":{"description":"Optional payload for non-error responses (typically null on errors)","nullable":true},"error":{"type":"string","nullable":true,"description":"Short, human-readable error summary"},"errors":{"type":"object","description":"Machine-readable error details","properties":{"detail":{"type":"string","description":"High-level error detail message"},"fields":{"type":"object","description":"Per-field validation errors when applicable"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (for rate limit errors)"}}},"meta":{"type":"object","description":"Optional metadata about the error (e.g., request_id, timestamp)"}}}},"responses":{"NotFound":{"description":"Not found - The requested resource does not exist\n","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/trading-accounts/{account_id}":{"get":{"tags":["Accounts"],"summary":"Get trading account details","description":"Get detailed information about a specific trading account.\n","operationId":"tradingGetTradingAccount","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the trading account (e.g., \"trading_account_6e6ad9d28eaae559\")\n"}],"responses":{"200":{"description":"Trading account details\n","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TradingAccount"}}}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```
---
# Agent Instructions: 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://thegrid.ai/docs/beta-trading-api/accounts.md?ask=
```
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.