Add a TRC20 token to the MPC-managed environment (MPC-driven mode).
Return: JSON object indicating success or failure.
-------------------- Request --------------------
addTrc20Token(
trc20_token=Trc20Token(
name="Decentralized USD",
symbol="USDD",
decimals="18",
address="TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz",
value_in_fiat="1",
gas_limit="300000"
),
request_extra_data=RequestExtraData(
str(uuid.uuid4()),
administrative_message_number=1
)
)
-------------------- Response --------------------
{
"FunctionData": {
"StatusCode": 0,
"StatusCodeDescription": "TRC20 token added successfully"
},
"Meta": {
"AccessToken": "e59612cdcb1242af750f4f8cc9032a4d44bfdb40b00bd19c5e5ef5d538fc74a0",
"Destination": "0473aa0362d3998baab6880822e838133a061c379b8e146bcded46deb4805aa83139a3c578293161bca7926e53ef20888977f4030c38d42aae10b36c3309c0f766",
"Source": "762b6aa122a0ba22557a0cf5ea0c49953e64f7485ffb7857f26541f748e36e83b2e4cca777569511214fcf68f3301a322bbdf15e7479ae0d695fcf40c30a81ff56",
"Time": "2025-09-30 15:25
.678"
}
}
Error Responses
| Error Type | Http Code | GK8 error code | Reason / Description | Example Response |
|------------------|-----------|----------------|--------------------------------------------------|------------------|
| Backend Response | 400 | 1 | Request exceeds allowed token limit | "StatusCode": 1 |
| Backend Response | 400 | 2 | Invalid TRC20 token name | "StatusCode": 2 |
| Backend Response | 400 | 3 | Contract address already assigned on TRX network | "StatusCode": 3 |
| Backend Response | 400 | 4 | Invalid TRC20 token symbol | "StatusCode": 4 |
| Backend Response | 400 | 5 | Invalid decimals amount | "StatusCode": 5 |
| Backend Response | 400 | 6 | Invalid contract address | "StatusCode": 6 |
| Backend Response | 400 | 7 | Invalid TRC20 token value in Fiat | "StatusCode": 7 |
| Backend Response | 400 | 8 | Invalid TRC20 token gas limit | "StatusCode": 8 |
| Backend Response | 400 | 9 | TRC20 token is not supported by TRX network | "StatusCode": 9 |
| Backend Response | 503 | 10 | Node is currently unavailable | "StatusCode": 10 |
| Backend Response | 400 | 11 | TRC20 token is deactivated in the cold machine | "StatusCode": 11 |
trc20_tokenobject<p>An instance of <strong>Trc20Token</strong> (see <code>apiclient/MpcDriven/Trc20Token.py</code>).</p>
request_extra_dataobject<p>Additional administrative context (maps to <strong>RequestExtraData</strong>).</p>