Wallet — API reference • URnetwork

GET/wallet/balanceBearer authWallet Balance

Get the balance for the USDC user custody wallet. The user custody wallet allows URnetwork to query the balance, but the user must take actions against the wallet.

Responses1 status · show schema

200

wallet_info

object

wallet_id

string

token_id

string

blockchain

string

blockchain_symbol

string

create_date

string

balance_usdc_nano_cents

integer

address

string

Response200

{
  "wallet_info": {
    "wallet_id": "string",
    "token_id": "string",
    "blockchain": "string",
    "blockchain_symbol": "string",
    "create_date": "string",
    "balance_usdc_nano_cents": 0,
    "address": "string"
  }
}

POST/wallet/validate-addressBearer authWallet Validate Address

Validate a USDC wallet address on the user custody wallet chain. This can be used to check whether an address can receive a transfer out from the user custody wallet. Please use this before initiating any transfer out to avoid lost funds.

Request bodyshow schema

address

string

chain

string

Optional. The blockchain the address is on. For a Circle chain this is the Circle blockchain param (see https://developers.circle.com/w3s/reference/createvalidateaddress) and validation is Circle's; TAO is validated locally as a Bittensor ss58 address and is recorded for future use only, never as a payout destination.

Responses1 status · show schema

200

valid

boolean

POST/wallet/circle-initBearer authWallet Circle Init

Initialize the Circle USDC user self custody wallet. This starts a process that must be completed by the user.

Responses1 status · show schema

200

user_token

object

user_token

string

encryption_key

string

challenge_id

string

error

object

message

string

POST/wallet/circle-transfer-outBearer authWallet Circle Transfer Out

Set up a transfer from the Circle USDC user self custody wallet to an address. This starts a process that must be completed by the user.

Request bodyshow schema

to_address

string

amount_usdc_nano_cents

integer

terms

boolean

user consent to accept terms of transfer

Responses1 status · show schema

200

user_token

object

user_token

string

encryption_key

string

challenge_id

string

error

object

message

string

Requestapplication/json

{
  "to_address": "string",
  "amount_usdc_nano_cents": 0,
  "terms": false
}

Response200

{
  "user_token": {
    "user_token": "string",
    "encryption_key": "string"
  },
  "challenge_id": "string",
  "error": {
    "message": "string"
  }
}