Venue
List Security Tokens
List the ERC-3643 tokens your instance has imported
GET
/
orderbooks
/
external-securities
/
api
/
security-tokens
curl "https://api.trusset.org/orderbooks/external-securities/api/security-tokens" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/external-securities/api/security-tokens',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const t of data.tokens) console.log(t.symbol, t.tokenAddress, t.decimals);
{
"success": true,
"data": {
"tokens": [
{
"id": "clx_extimp_017",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"decimals": 18,
"framework": "erc3643",
"assetType": "FUND",
"imageURI": "ipfs://bafybeigd...",
"totalSupply": "1000000000000000000000000",
"status": "active",
"importedAt": "2025-05-20T14:12:00.000Z"
}
]
}
}
Returns the ERC-3643 security tokens imported into your instance and still active, newest first. These are the tokens you can open an order book on.
Only tokens whose framework is recorded as ERC-3643 appear. A token imported under another framework is not tradable on this venue, because the settlement path depends on the T-REX delivery role.
Importing a token is a separate step from opening a book on it. This endpoint shows what has been imported; Create Order Book is what makes one tradable.
Response Fields
object
Show child attributes
Show child attributes
array
Show child attributes
Show child attributes
string
Import record ID.
string
Security token contract.
string
Token name.
string
Token symbol.
integer
Token decimals as reported on chain.
string
erc3643.string
Issuer-declared asset class, or
null.string
Token image, or
null.string
Supply recorded at import, in base units.
string
active.string
ISO 8601 timestamp.
decimals here is the token’s own decimals. Order quantities are order book units with 6 decimal places, and the book converts between the two. A token with fewer than 6 decimals constrains the quantities it will accept; see Units and decimals.curl "https://api.trusset.org/orderbooks/external-securities/api/security-tokens" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/external-securities/api/security-tokens',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const t of data.tokens) console.log(t.symbol, t.tokenAddress, t.decimals);
{
"success": true,
"data": {
"tokens": [
{
"id": "clx_extimp_017",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"decimals": 18,
"framework": "erc3643",
"assetType": "FUND",
"imageURI": "ipfs://bafybeigd...",
"totalSupply": "1000000000000000000000000",
"status": "active",
"importedAt": "2025-05-20T14:12:00.000Z"
}
]
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
SERVICE_NOT_ENABLED | 403 | The Trading service is not enabled on this instance |
⌘I
curl "https://api.trusset.org/orderbooks/external-securities/api/security-tokens" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/external-securities/api/security-tokens',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const t of data.tokens) console.log(t.symbol, t.tokenAddress, t.decimals);
{
"success": true,
"data": {
"tokens": [
{
"id": "clx_extimp_017",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"decimals": 18,
"framework": "erc3643",
"assetType": "FUND",
"imageURI": "ipfs://bafybeigd...",
"totalSupply": "1000000000000000000000000",
"status": "active",
"importedAt": "2025-05-20T14:12:00.000Z"
}
]
}
}