curl --request GET \
--url https://api.citadel.example/api/v1/prices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.citadel.example/api/v1/prices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.citadel.example/api/v1/prices"
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/prices"
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))
}{
"data": [
{
"asset": "TRX",
"contract": null,
"chain": "tron",
"instance": "tron",
"usd": "0.2412",
"as_of": "2026-10-08T12:00:00Z"
},
{
"asset": "USDT",
"contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"chain": "tron",
"instance": "tron",
"usd": "0.9998",
"as_of": "2026-10-08T12:00:00Z"
},
{
"asset": "USDD",
"contract": "TPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn",
"chain": "tron",
"instance": "tron",
"usd": null,
"as_of": null
}
]
}List asset prices
A price in US dollars for every asset GET /assets lists on one network — to show an
amount in dollars next to its base units. For display only: Citadel locks no rate, and
nothing is charged or settled at this price.
usd is the median of the recent quotes of the asset’s market from the price sources your
installation asks, as a decimal string; as_of is the time of the oldest quote it is made
of. Quotes older than the installation’s freshness limit (10 minutes unless configured
otherwise) are not used: an asset with no recent quote has usd: null, never a guess. Your
approval rules judge their dollar steps by the highest recent quote, not this median, so the
two can differ slightly. A test network’s tokens are priced as the market they stand for.
network is required. Needs the read scope.
curl --request GET \
--url https://api.citadel.example/api/v1/prices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.citadel.example/api/v1/prices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.citadel.example/api/v1/prices"
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/prices"
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))
}{
"data": [
{
"asset": "TRX",
"contract": null,
"chain": "tron",
"instance": "tron",
"usd": "0.2412",
"as_of": "2026-10-08T12:00:00Z"
},
{
"asset": "USDT",
"contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"chain": "tron",
"instance": "tron",
"usd": "0.9998",
"as_of": "2026-10-08T12:00:00Z"
},
{
"asset": "USDD",
"contract": "TPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn",
"chain": "tron",
"instance": "tron",
"usd": null,
"as_of": null
}
]
}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.
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 Only the assets of this chain.
tron, evm, solana, ton Response
A price per asset credited.
Show child attributes
Show child attributes