Blockchain wallets

Returns the list of blockchain wallets.

get

The blockchain wallets are sorted by creation date, with the most recent blockchain wallet appearing first.

Authorizations

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.rialtobridge.xyz/api/client/v1/blockchain-wallets' \
  --header 'RIALTO_API_KEY: YOUR_API_KEY'

200

401

500

200

[
  {
    "id": "3c42718a-5b6c-4858-a6b1-2e231deff900",
    "label": "Main Ethereum Mainnet",
    "blockchainNetwork": "ethereum",
    "address": "0x9b7E335088762aD8061C04D08C37902ABC8ACb87",
    "createdAt": "2024-12-01T09:07:54.940Z",
    "approvedAt": "2024-12-01T12:00:12.125Z",
    "deletedAt": null
  }
]

A JSON array of blockchain wallets.

Request the creation of a blockchain wallet.

post

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.

Authorizations

Body

labelstring | nulloptional

The label of the blockchain wallet.

blockchainNetworkstringrequired

The blockchain network of the wallet. See the list of supported blockchains.

addressstringrequired

The address of the blockchain wallet.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.rialtobridge.xyz/api/client/v1/blockchain-wallets' \
  --header 'RIALTO_API_KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "label": "Main Ethereum Mainnet",
    "blockchainNetwork": "ethereum",
    "address": "0x9b7E335088762aD8061C04D08C37902ABC8ACb87"
  }'

201

400

401

500

201

{
  "id": "3c42718a-5b6c-4858-a6b1-2e231deff900",
  "label": "Main Ethereum Mainnet",
  "blockchainNetwork": "ethereum",
  "address": "0x9b7E335088762aD8061C04D08C37902ABC8ACb87",
  "createdAt": "2024-12-01T09:07:54.940Z",
  "approvedAt": null,
  "deletedAt": null
}

The blockchain wallet has been created.

Returns a blockchain wallet by ID.

get

Returns a blockchain wallet by its unique identifier.

Authorizations

Path parameters

blockchainWalletIdstring · uuidrequired

The unique identifier of the blockchain wallet.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.rialtobridge.xyz/api/client/v1/blockchain-wallets/{blockchainWalletId}' \
  --header 'RIALTO_API_KEY: YOUR_API_KEY'

200

401

404

500

200

{
  "id": "3c42718a-5b6c-4858-a6b1-2e231deff900",
  "label": "Main Ethereum Mainnet",
  "blockchainNetwork": "ethereum",
  "address": "0x9b7E335088762aD8061C04D08C37902ABC8ACb87",
  "createdAt": "2024-12-01T09:07:54.940Z",
  "approvedAt": "2024-12-01T12:00:12.125Z",
  "deletedAt": null
}

A blockchain wallet.

Deletes a blockchain wallet by ID.

delete

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.

Authorizations

Path parameters

blockchainWalletIdstring · uuidrequired

The unique identifier of the blockchain wallet.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://api.rialtobridge.xyz/api/client/v1/blockchain-wallets/{blockchainWalletId}' \
  --header 'RIALTO_API_KEY: YOUR_API_KEY'

200

400

401

404

500

200

{
  "id": "3c42718a-5b6c-4858-a6b1-2e231deff900",
  "label": "Main Ethereum Mainnet",
  "blockchainNetwork": "ethereum",
  "address": "0x9b7E335088762aD8061C04D08C37902ABC8ACb87",
  "createdAt": "2024-12-01T09:07:54.940Z",
  "approvedAt": "2024-12-01T12:00:12.125Z",
  "deletedAt": "2024-12-25T00:07:54.940Z"
}

The blockchain wallet has been deleted.