curl --request GET \
--url https://api.citadel.example/api/v1/wallets/{reference} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.citadel.example/api/v1/wallets/{reference}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.citadel.example/api/v1/wallets/{reference}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.citadel.example/api/v1/wallets/{reference}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"reference": "<string>",
"chain": "tron",
"network": "mainnet",
"status": "creating",
"created_at": "2023-11-07T05:31:56Z",
"address": "<string>",
"label": "<string>",
"tags": [
"<string>"
],
"end_user_ref": "<string>",
"vault": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_implementation": "<string>"
}Get a wallet
Reads a wallet by your reference (within network) or by its id. network is
required; a wallet named by its id must live on it, else 422 network_mismatch.
Needs the read scope. A wallet outside the key’s vaults answers 404.
curl --request GET \
--url https://api.citadel.example/api/v1/wallets/{reference} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.citadel.example/api/v1/wallets/{reference}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.citadel.example/api/v1/wallets/{reference}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.citadel.example/api/v1/wallets/{reference}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"reference": "<string>",
"chain": "tron",
"network": "mainnet",
"status": "creating",
"created_at": "2023-11-07T05:31:56Z",
"address": "<string>",
"label": "<string>",
"tags": [
"<string>"
],
"end_user_ref": "<string>",
"vault": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_implementation": "<string>"
}Authorizations
An API key minted in the console (ctd_…). Authenticates; never authorizes funds. A key
carries scopes (read, wallets.write, transactions.write, events.write,
webhooks.write, policy.write) and may be limited to vaults, to IP addresses, and in
lifetime — see Authentication.
Path Parameters
Your reference for the wallet, or its id.
Query Parameters
The network the data lives on. Required — there is no default network: without it,
422 network_required. A wallet named by its id on another network: 422 network_mismatch.
The network the data lives on. Required wherever it appears in a request — there is no
default network. One your installation does not serve: 422 network_not_served.
mainnet, testnet Response
The wallet.
tron, evm, solana, ton The network the data lives on. Required wherever it appears in a request — there is no
default network. One your installation does not serve: 422 network_not_served.
mainnet, testnet creating — issued, your signer has not derived it yet; active — in circulation;
retired — out of circulation (POST /wallets/{reference}/retire): still watched,
credited, and able to send; failed — your signer could not derive it, it has no address.
creating, active, retired, failed Absent while creating, and on a failed wallet.
The vault the wallet is in.