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

# Trading Wallets

List, create and rename trading wallets and pick the default one.

## Get Trading Wallets

> Returns a list of trading wallets for the authenticated user. Trading wallets are custodial wallets used for executing trades through Cielo's trading infrastructure.\
> Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 5 credits.<br>

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"tags":[{"name":"Trading Wallets","description":"List, create and rename trading wallets and pick the default one."}],"servers":[{"url":"https://api.cielo.finance","description":"Endpoint"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"ErrorResponse":{"type":"object","description":"This object represents a response structure typically used to convey the outcome of a request. It primarily consists of a status indicator and a message, which together provide essential feedback about the request's processing. The status reflects the overall result of the request (such as success, error, etc.), while the message gives a more detailed explanation or the nature of the response, especially useful in cases of errors or exceptions.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the response status object. This status is a key indicator of whether the request was processed successfully or resulted in an error."},"data":{"type":"object","description":"A flexible object intended to hold the actual data payload of the response. The structure of this object can vary depending on the specific endpoint and the nature of the response."},"message":{"type":"string","description":"A descriptive message providing additional details about the response. In case of an error, this message typically contains information useful for understanding the error's cause or nature."}},"required":["status","message"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}},"paths":{"/api/trading/wallets":{"get":{"tags":["Trading Wallets"],"summary":"Get Trading Wallets","description":"Returns a list of trading wallets for the authenticated user. Trading wallets are custodial wallets used for executing trades through Cielo's trading infrastructure.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 5 credits.\n","operationId":"getTradingWallets","parameters":[{"name":"chain","in":"query","description":"Blockchain chain filter (e.g. solana, base).","required":true,"schema":{"type":"string"}},{"name":"include_archived","in":"query","description":"Include archived wallets.","required":false,"schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"List of trading wallets","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/paths/~1api~1trading~1wallets/post/responses/200/content/application~1json/schema/properties/data"}}}}}}},"400":{"description":"Bad request - chain is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden - Invalid API key or plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Create Trading Wallet

> Creates a new trading wallet for the authenticated user on the given chain.\
> Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 10 credits.<br>

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"tags":[{"name":"Trading Wallets","description":"List, create and rename trading wallets and pick the default one."}],"servers":[{"url":"https://api.cielo.finance","description":"Endpoint"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"ErrorResponse":{"type":"object","description":"This object represents a response structure typically used to convey the outcome of a request. It primarily consists of a status indicator and a message, which together provide essential feedback about the request's processing. The status reflects the overall result of the request (such as success, error, etc.), while the message gives a more detailed explanation or the nature of the response, especially useful in cases of errors or exceptions.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the response status object. This status is a key indicator of whether the request was processed successfully or resulted in an error."},"data":{"type":"object","description":"A flexible object intended to hold the actual data payload of the response. The structure of this object can vary depending on the specific endpoint and the nature of the response."},"message":{"type":"string","description":"A descriptive message providing additional details about the response. In case of an error, this message typically contains information useful for understanding the error's cause or nature."}},"required":["status","message"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}},"paths":{"/api/trading/wallets":{"post":{"tags":["Trading Wallets"],"summary":"Create Trading Wallet","description":"Creates a new trading wallet for the authenticated user on the given chain.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 10 credits.\n","operationId":"createTradingWallet","parameters":[{"name":"chain","in":"query","description":"Blockchain chain (e.g. solana, base). Defaults to solana.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Created trading wallet","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"address":{"type":"string"},"wallet_name":{"type":"string"},"is_default":{"type":"boolean"},"is_enabled":{"type":"boolean"},"is_archived":{"type":"boolean"},"chain":{"type":"string"},"balance":{"type":"number"},"balance_usd":{"type":"number"},"usdc_balance":{"type":"number"}}}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get Default Trading Wallet

> Returns the default trading wallet for the specified chain.\
> Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 5 credits.<br>

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"tags":[{"name":"Trading Wallets","description":"List, create and rename trading wallets and pick the default one."}],"servers":[{"url":"https://api.cielo.finance","description":"Endpoint"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"ErrorResponse":{"type":"object","description":"This object represents a response structure typically used to convey the outcome of a request. It primarily consists of a status indicator and a message, which together provide essential feedback about the request's processing. The status reflects the overall result of the request (such as success, error, etc.), while the message gives a more detailed explanation or the nature of the response, especially useful in cases of errors or exceptions.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the response status object. This status is a key indicator of whether the request was processed successfully or resulted in an error."},"data":{"type":"object","description":"A flexible object intended to hold the actual data payload of the response. The structure of this object can vary depending on the specific endpoint and the nature of the response."},"message":{"type":"string","description":"A descriptive message providing additional details about the response. In case of an error, this message typically contains information useful for understanding the error's cause or nature."}},"required":["status","message"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}},"paths":{"/api/trading/wallets/default":{"get":{"tags":["Trading Wallets"],"summary":"Get Default Trading Wallet","description":"Returns the default trading wallet for the specified chain.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 5 credits.\n","operationId":"getDefaultTradingWallet","parameters":[{"name":"chain","in":"query","description":"Blockchain chain (e.g. solana, base).","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Default trading wallet","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/paths/~1api~1trading~1wallets/post/responses/200/content/application~1json/schema/properties/data"}}}}}},"400":{"description":"Bad request - chain is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Default trading wallet not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Set Default Trading Wallet

> Sets a specific trading wallet as the user's default wallet.\
> Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 2 credits.<br>

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"tags":[{"name":"Trading Wallets","description":"List, create and rename trading wallets and pick the default one."}],"servers":[{"url":"https://api.cielo.finance","description":"Endpoint"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"ErrorResponse":{"type":"object","description":"This object represents a response structure typically used to convey the outcome of a request. It primarily consists of a status indicator and a message, which together provide essential feedback about the request's processing. The status reflects the overall result of the request (such as success, error, etc.), while the message gives a more detailed explanation or the nature of the response, especially useful in cases of errors or exceptions.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the response status object. This status is a key indicator of whether the request was processed successfully or resulted in an error."},"data":{"type":"object","description":"A flexible object intended to hold the actual data payload of the response. The structure of this object can vary depending on the specific endpoint and the nature of the response."},"message":{"type":"string","description":"A descriptive message providing additional details about the response. In case of an error, this message typically contains information useful for understanding the error's cause or nature."}},"required":["status","message"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}},"paths":{"/api/trading/wallets/{wallet_id}/default":{"put":{"tags":["Trading Wallets"],"summary":"Set Default Trading Wallet","description":"Sets a specific trading wallet as the user's default wallet.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 2 credits.\n","operationId":"setDefaultTradingWallet","parameters":[{"name":"wallet_id","in":"path","description":"Trading wallet ID.","required":true,"schema":{"type":"string"}},{"name":"chain","in":"query","description":"Blockchain chain filter.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Wallet set as default","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/paths/~1api~1trading~1wallets/post/responses/200/content/application~1json/schema/properties/data"}}}}}},"400":{"description":"Bad request - wallet_id is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Rename Trading Wallet

> Updates the display name of a trading wallet.\
> Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 2 credits.<br>

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"tags":[{"name":"Trading Wallets","description":"List, create and rename trading wallets and pick the default one."}],"servers":[{"url":"https://api.cielo.finance","description":"Endpoint"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"ErrorResponse":{"type":"object","description":"This object represents a response structure typically used to convey the outcome of a request. It primarily consists of a status indicator and a message, which together provide essential feedback about the request's processing. The status reflects the overall result of the request (such as success, error, etc.), while the message gives a more detailed explanation or the nature of the response, especially useful in cases of errors or exceptions.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the response status object. This status is a key indicator of whether the request was processed successfully or resulted in an error."},"data":{"type":"object","description":"A flexible object intended to hold the actual data payload of the response. The structure of this object can vary depending on the specific endpoint and the nature of the response."},"message":{"type":"string","description":"A descriptive message providing additional details about the response. In case of an error, this message typically contains information useful for understanding the error's cause or nature."}},"required":["status","message"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}},"paths":{"/api/trading/wallets/{wallet_id}/name":{"put":{"tags":["Trading Wallets"],"summary":"Rename Trading Wallet","description":"Updates the display name of a trading wallet.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 2 credits.\n","operationId":"updateTradingWalletName","parameters":[{"name":"wallet_id","in":"path","description":"Trading wallet ID.","required":true,"schema":{"type":"string"}},{"name":"chain","in":"query","description":"Blockchain chain filter.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"new_name":{"type":"string","description":"New wallet name (1-100 characters).","minLength":1,"maxLength":100}},"required":["new_name"]}}}},"responses":{"200":{"description":"Wallet renamed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/paths/~1api~1trading~1wallets/post/responses/200/content/application~1json/schema/properties/data"}}}}}},"400":{"description":"Bad request - invalid wallet_id or name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
