LogoLogo
  • Getting started
    • Overview
    • Quick start
    • Integration
  • Products
    • Fiat <> Crypto conversions
    • Third Party Payments
    • Segregated Accounts
  • Concepts
    • Authentication
    • Idempotency
    • Onboarding
    • Fees and Limits
    • Accounts
      • Client Accounts
      • Manager Accounts
    • Bank Accounts and Wallet Addresses
    • Supported Fiat Currencies, Blockchain Assets and Blockchain Networks
    • Webhooks
    • Document Management
  • Client API reference
    • Transactions
    • Preset fees
    • Deposit instructions
    • Bank accounts
    • Blockchain wallets
    • User
    • Uploads (temporary storage)
    • Documents (permanent storage)
    • Constants
    • Simulate
    • Models
  • Client Specification
  • Manager API reference
    • Clients
    • Clients onboarding
    • Client bank accounts
    • Client blockchain wallets
    • Client preset fees
    • Client deposit instructions
    • Client transactions
    • Transactions
    • Manager preset fees
    • Deposit instructions
    • Uploads (temporary storage)
    • Documents (permanent storage)
    • Webhooks
    • Constants
    • Simulate
    • Models
  • Manager Specification
Powered by GitBook
On this page
  1. Client API reference

Blockchain wallets

PreviousBank accountsNextUser

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
200
A blockchain wallet.
application/json
401
Invalid API key
404
Blockchain wallet not found.
500
An unexpected error occurred.
get
GET /api/client/v1/blockchain-wallets/{blockchainWalletId} HTTP/1.1
Host: api.rialtobridge.xyz
RIALTO_API_KEY: YOUR_API_KEY
Accept: */*

{
  "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
}

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
200
The blockchain wallet has been deleted.
application/json
400
The request is invalid.
application/json
401
Invalid API key
404
Blockchain wallet not found.
500
An unexpected error occurred.
delete
DELETE /api/client/v1/blockchain-wallets/{blockchainWalletId} HTTP/1.1
Host: api.rialtobridge.xyz
RIALTO_API_KEY: YOUR_API_KEY
Accept: */*

{
  "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"
}
  • GETReturns the list of blockchain wallets.
  • POSTRequest the creation of a blockchain wallet.
  • GETReturns a blockchain wallet by ID.
  • DELETEDeletes a blockchain wallet by ID.

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
200
A JSON array of blockchain wallets.
application/json
401
Invalid API key
500
An unexpected error occurred.
get
GET /api/client/v1/blockchain-wallets HTTP/1.1
Host: api.rialtobridge.xyz
RIALTO_API_KEY: YOUR_API_KEY
Accept: */*

[
  {
    "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
  }
]

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
201
The blockchain wallet has been created.
application/json
400
The request is invalid.
application/json
401
Invalid API key
500
An unexpected error occurred.
post
POST /api/client/v1/blockchain-wallets HTTP/1.1
Host: api.rialtobridge.xyz
RIALTO_API_KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 119

{
  "label": "Main Ethereum Mainnet",
  "blockchainNetwork": "ethereum",
  "address": "0x9b7E335088762aD8061C04D08C37902ABC8ACb87"
}
{
  "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
}