# Blockchain wallets
## Returns the list of blockchain wallets.
> The blockchain wallets are sorted by creation date, with the most recent blockchain wallet appearing first.
```json
{"openapi":"3.1.0","info":{"title":"Rialto API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/client/v1","description":"Main (production) server for the Rialto Client API"},{"url":"https://staging.api.rialtobridge.xyz/api/client/v1","description":"Test (staging) server for the Rialto Client API"},{"url":"http://localhost:3002/api/client/v1","description":"Development server for the Rialto Client 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":{"/blockchain-wallets":{"get":{"summary":"Returns the list of blockchain wallets.","description":"The blockchain wallets are sorted by creation date, with the most recent blockchain wallet appearing first.","operationId":"getBlockchainWallets","tags":["Blockchain wallets"],"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 API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/client/v1","description":"Main (production) server for the Rialto Client API"},{"url":"https://staging.api.rialtobridge.xyz/api/client/v1","description":"Test (staging) server for the Rialto Client API"},{"url":"http://localhost:3002/api/client/v1","description":"Development server for the Rialto Client 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":{"/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":"createBlockchainWallet","tags":["Blockchain wallets"],"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 API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/client/v1","description":"Main (production) server for the Rialto Client API"},{"url":"https://staging.api.rialtobridge.xyz/api/client/v1","description":"Test (staging) server for the Rialto Client API"},{"url":"http://localhost:3002/api/client/v1","description":"Development server for the Rialto Client 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":{"/blockchain-wallets/{blockchainWalletId}":{"get":{"summary":"Returns a blockchain wallet by ID.","description":"Returns a blockchain wallet by its unique identifier.","operationId":"getBlockchainWalletById","parameters":[{"name":"blockchainWalletId","in":"path","required":true,"description":"The unique identifier of the blockchain wallet.","schema":{"type":"string","format":"uuid"}}],"tags":["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 user 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 API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/client/v1","description":"Main (production) server for the Rialto Client API"},{"url":"https://staging.api.rialtobridge.xyz/api/client/v1","description":"Test (staging) server for the Rialto Client API"},{"url":"http://localhost:3002/api/client/v1","description":"Development server for the Rialto Client 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":{"/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 user 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":"deleteBlockchainWalletById","parameters":[{"name":"blockchainWalletId","in":"path","required":true,"description":"The unique identifier of the blockchain wallet.","schema":{"type":"string","format":"uuid"}}],"tags":["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/client-api-reference/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.