# Client blockchain wallets
## Returns the list of blockchain wallets of a client.
> The blockchain wallets are sorted by creation date, in descending order. The most recently created blockchain wallets appear first.
```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"schemas":{"BlockchainWallet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the blockchain wallet."},"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the blockchain wallet."},"approvedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was approved.
Only present if the blockchain wallet aws approved.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was deleted.
Only present if the blockchain wallet was deleted.\n"}}}}},"paths":{"/clients/{clientId}/blockchain-wallets":{"get":{"summary":"Returns the list of blockchain wallets of a client.","description":"The blockchain wallets are sorted by creation date, in descending order. The most recently created blockchain wallets appear first.","operationId":"getClientBlockchainWallets","tags":["Client blockchain wallets"],"parameters":[{"name":"clientId","in":"path","required":true,"description":"The unique identifier of the client.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"A JSON array of blockchain wallets.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BlockchainWallet"}}}}},"401":{"description":"Invalid API key"},"500":{"description":"An unexpected error occurred."}}}}}}
```
## Request the creation of a blockchain wallet.
> Creates a blockchain wallet with the specified parameters.\
The blockchain wallet is created in a pending state and must be approved by an administrator before it can be used in transactions.\
This route is \*\*only available for verified clients\*\*. Unverified clients will receive a 400 error.
```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"requestBodies":{"CreateBlockchainWallet":{"required":true,"description":"The parameters to create a blockchain wallet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBlockchainWalletPayload","required":["blockchainNetwork","address"]}}}}},"schemas":{"CreateBlockchainWalletPayload":{"type":"object","properties":{"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."}}},"BlockchainWallet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the blockchain wallet."},"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the blockchain wallet."},"approvedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was approved.
Only present if the blockchain wallet aws approved.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was deleted.
Only present if the blockchain wallet was deleted.\n"}}}}},"paths":{"/clients/{clientId}/blockchain-wallets":{"post":{"summary":"Request the creation of a blockchain wallet.","description":"Creates a blockchain wallet with the specified parameters.
The blockchain wallet is created in a pending state and must be approved by an administrator before it can be used in transactions.
This route is **only available for verified clients**. Unverified clients will receive a 400 error.\n","operationId":"createClientBlockchainWallet","tags":["Client blockchain wallets"],"parameters":[{"name":"clientId","in":"path","required":true,"description":"The unique identifier of the client.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"$ref":"#/components/requestBodies/CreateBlockchainWallet"},"responses":{"201":{"description":"The blockchain wallet has been created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockchainWallet"}}}},"400":{"description":"The request is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"The reason why the request is invalid."},"parameterErrors":{"type":["object","null"],"description":"The errors related to the parameters of the request.
The object is null if there is no error related to the parameters.\n"}}}}}},"401":{"description":"Invalid API key"},"500":{"description":"An unexpected error occurred."}}}}}}
```
## Returns a blockchain wallet by ID.
> Returns a blockchain wallet by its unique identifier.
```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"schemas":{"BlockchainWallet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the blockchain wallet."},"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the blockchain wallet."},"approvedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was approved.
Only present if the blockchain wallet aws approved.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was deleted.
Only present if the blockchain wallet was deleted.\n"}}}}},"paths":{"/clients/{clientId}/blockchain-wallets/{blockchainWalletId}":{"get":{"summary":"Returns a blockchain wallet by ID.","description":"Returns a blockchain wallet by its unique identifier.","operationId":"getClientBlockchainWalletById","parameters":[{"name":"clientId","in":"path","required":true,"description":"The unique identifier of the client.","schema":{"type":"string","format":"uuid"}},{"name":"blockchainWalletId","in":"path","required":true,"description":"The unique identifier of the blockchain wallet.","schema":{"type":"string","format":"uuid"}}],"tags":["Client blockchain wallets"],"responses":{"200":{"description":"A blockchain wallet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockchainWallet"}}}},"401":{"description":"Invalid API key"},"404":{"description":"Blockchain wallet not found."},"500":{"description":"An unexpected error occurred."}}}}}}
```
## Deletes a blockchain wallet by ID.
> Deletes a blockchain wallet by its unique identifier.\
A deleted blockchain wallet will still be returned in the list of blockchain wallets of the client or queriable by ID, but it will have a non null \`deletedAt\` field.\
A deleted blockchain wallet can not be used in transactions.\
This route is \*\*only available for verified clients\*\*. Unverified clients will receive a 400 error.
```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"schemas":{"BlockchainWallet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the blockchain wallet."},"label":{"type":["string","null"],"description":"The label of the blockchain wallet."},"blockchainNetwork":{"type":"string","description":"The blockchain network of the wallet. See [the list of supported](https://docs.rialtobridge.xyz/concepts) blockchains."},"address":{"type":"string","description":"The address of the blockchain wallet."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the blockchain wallet."},"approvedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was approved.
Only present if the blockchain wallet aws approved.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"The date when the blockchain wallet was deleted.
Only present if the blockchain wallet was deleted.\n"}}}}},"paths":{"/clients/{clientId}/blockchain-wallets/{blockchainWalletId}":{"delete":{"summary":"Deletes a blockchain wallet by ID.","description":"Deletes a blockchain wallet by its unique identifier.
A deleted blockchain wallet will still be returned in the list of blockchain wallets of the client or queriable by ID, but it will have a non null `deletedAt` field.
A deleted blockchain wallet can not be used in transactions.
This route is **only available for verified clients**. Unverified clients will receive a 400 error.\n","operationId":"deleteClientBlockchainWalletById","parameters":[{"name":"clientId","in":"path","required":true,"description":"The unique identifier of the client.","schema":{"type":"string","format":"uuid"}},{"name":"blockchainWalletId","in":"path","required":true,"description":"The unique identifier of the blockchain wallet.","schema":{"type":"string","format":"uuid"}}],"tags":["Client blockchain wallets"],"responses":{"200":{"description":"The blockchain wallet has been deleted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockchainWallet"}}}},"400":{"description":"The request is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"The reason why the request is invalid."}}}}}},"401":{"description":"Invalid API key"},"404":{"description":"Blockchain wallet not found."},"500":{"description":"An unexpected error occurred."}}}}}}
```
---
# 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://docs.rialtobridge.xyz/manager-api-reference/client-blockchain-wallets.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.