/addErc20Token

1 min

POST

/addErc20Token

This API allows to add an ERC20 token from the MPC.

Request Example:

.. code-block::

addErc20Token( erc20_token={ name="Polygon", symbol="MATIC", evm_network_symbol="ETH", decimals="18", address="0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0", value_in_fiat="1", gas_limit="100000", max_fee_limit="100", system_max_fee="50" }, request_extra_data={ "message_number": 5, "session_id": "3478593863424051983840947" } )

Response Example:

.. code-block::

{
    "FunctionData": {
         StatusCode=0,
         StatusCodeDescription="ERC20 token added successfully"
    },
    "Meta": {
        "AccessToken": "2911...9a7",
        "Destination": "04bc...9e2",
        "Source": "3dcf...ba4",
        "Time": "2025-05-22 17:00:44.605"
    }
}

Response Structure:

FunctionData:
- **StatusCode: The status code of the operation (e.g., 0 for OK).
- **StatusCodeDescription: Description of the status code (e.g.,"ERC20 token added successfully")
Meta: Metadata common to all API responses.
- AccessToken: Authentication token for the API session.
- Destination: Target identifier for the request.
- Source: Origin identifier for the request.
- Time: Timestamp when the response was generated.

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 ERC20 token name	"StatusCode": 2
Backend Response	400	3	Contract address already assigned on EVM network	"StatusCode": 3
Backend Response	400	4	Invalid ERC20 token symbol	"StatusCode": 4
Backend Response	400	5	Invalid EVM network symbol	"StatusCode": 5
Backend Response	400	6	Invalid decimals amount	"StatusCode": 6
Backend Response	400	7	Invalid contract address	"StatusCode": 7
Backend Response	400	8	Invalid ERC20 token value in Fiat	"StatusCode": 8
Backend Response	400	9	Invalid ERC20 token gas limit	"StatusCode": 9
Backend Response	400	10	Invalid ERC20 token max fee limit	"StatusCode": 10
Backend Response	400	11	Invalid ERC20 token internal transaction fee	"StatusCode": 11
Backend Response	400	12	ERC20 token is not supported by EVM network	"StatusCode": 12
Backend Response	503	13	Node is currently unavailable	"StatusCode": 13
Backend Response	400	14	ERC20 token is deactivated in the cold machine	"StatusCode": 14

erc20_tokenobject<p>additional data for the administrative request (currently used only for administrative requests)</p>

request_extra_dataobject<p>additional data for the administrative request (currently used only for administrative requests)</p>

acceptstringGenerated from available response content types

bodyobject

200success

curl --request POST \
     --url '/addErc20Token?erc20_token={%0A%20%20%22Address%22%3A%20%220x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1%22%2C%0A%20%20%22Decimals%22%3A%20%2218%22%2C%0A%20%20%22EvmNetworkSymbol%22%3A%20%22CELO%22%2C%0A%20%20%22GasLimit%22%3A%20%221000000%22%2C%0A%20%20%22MaxFeeLimit%22%3A%20%2210000000000%22%2C%0A%20%20%22Name%22%3A%20%22CUSD%20Celo%20Testnet%22%2C%0A%20%20%22Symbol%22%3A%20%22CUSD%22%2C%0A%20%20%22SystemMaxFee%22%3A%20%220%22%2C%0A%20%20%22ValueInFiat%22%3A%20%221%22%0A%0A}%0A&request_extra_data={%0A%20%20%22MessageNumber%22%3A%202%2C%0A%20%20%22SessionId%22%3A%20%226603931f-d359-46fa-a386-6473c4259cc7%22%0A}%0A' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "FunctionData": {
     "Erc20Token": {
     "Address": "0x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1",
     "Decimals": "18",
     "EvmNetworkSymbol": "CELO",
     "GasLimit": "1000000",
     "MaxFeeLimit": "10000000000",
     "Name": "CUSD Celo Testnet",
     "Symbol": "CUSD",
     "SystemMaxFee": "0",
     "ValueInFiat": "1"
     },
     "RequestExtraData": {
     "MessageNumber": 2,
     "SessionId": "af0c1637-a7dc-484c-9ab4-98c3a3a431a4"
     }
     },
     "Meta": {
     "FunctionName": "addErc20Token",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'