Importing
Update Label
Set or clear the label on an imported token
PUT
/
external-tokens
/
api
/
{tokenAddress}
/
label
curl -X PUT "https://api.trusset.org/external-tokens/api/0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f/label" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{"label": "Real estate"}'
await fetch(
`https://api.trusset.org/external-tokens/api/${tokenAddress}/label`,
{
method: 'PUT',
headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
body: JSON.stringify({ label: null })
}
);
{
"success": true,
"data": {
"tokenAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
"label": "Real estate",
"previousLabel": null,
"updatedAt": "2026-11-21T12:22:00.000Z"
}
}
Sets the label on an import record, or clears it. A label is your own short text for grouping imports, for example
Real estate. It is private to your instance and carries no meaning on chain. Removing the import removes its label.
An instance keeps at most 50 different labels.
Path Parameters
Body Parameters
Text of at most 40 characters, without control characters and without angle brackets. Whitespace is collapsed and trimmed before the label is stored.Send
null to clear the label. An empty string clears it as well.Only the label field is accepted.Response Fields
curl -X PUT "https://api.trusset.org/external-tokens/api/0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f/label" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{"label": "Real estate"}'
await fetch(
`https://api.trusset.org/external-tokens/api/${tokenAddress}/label`,
{
method: 'PUT',
headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
body: JSON.stringify({ label: null })
}
);
{
"success": true,
"data": {
"tokenAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
"label": "Real estate",
"previousLabel": null,
"updatedAt": "2026-11-21T12:22:00.000Z"
}
}
Rate Limit
Strict: 10 requests per minute.Error Codes
| Code | HTTP | Cause |
|---|---|---|
INVALID_LABEL | 400 | label is not text of at most 40 characters, or carries a control character or an angle bracket. Send null to clear |
LABEL_LIMIT_REACHED | 400 | Your instance already keeps 50 different labels |
IMPORT_NOT_FOUND | 404 | No active import for that address on your instance |
LABELS_UNAVAILABLE | 503 | Labels are unavailable just now |
⌘I
curl -X PUT "https://api.trusset.org/external-tokens/api/0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f/label" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{"label": "Real estate"}'
await fetch(
`https://api.trusset.org/external-tokens/api/${tokenAddress}/label`,
{
method: 'PUT',
headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
body: JSON.stringify({ label: null })
}
);
{
"success": true,
"data": {
"tokenAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
"label": "Real estate",
"previousLabel": null,
"updatedAt": "2026-11-21T12:22:00.000Z"
}
}
