TokensRegister a token

Register a token

Adds a token to the global registry. The network must come from the Networks registry (by networkCode). Uniqueness: code globally, contractAddress within a network, one native coin per network. contractAddress is required for non-native tokens (the webhook uses it to verify incoming transfers).

curl -X POST "https://policy-engine-rest.ezig.workers.dev/api/v1/tokens" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "code": "usdt",
  "symbol": "USDT",
  "name": "Tether USD",
  "networkCode": "tron_network",
  "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "decimals": 6,
  "isNative": true,
  "logoUri": "https://cdn.example.com/tokens/usdt.png"
}'
{
  "id": "cmr3f41z20001psp7phmyapw3",
  "code": "usdt",
  "symbol": "USDT",
  "name": "Tether USD",
  "networkId": "example_string",
  "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "decimals": 6,
  "isNative": true,
  "enabled": true,
  "logoUri": "https://cdn.example.com/tokens/usdt.png",
  "createdAt": "2026-07-02T11:25:15.134000Z",
  "updatedAt": "2026-07-02T11:25:15.134000Z",
  "network": {
    "id": "cmr3f41z20001psp7phmyapw3",
    "coinType": 195,
    "code": "tron_network",
    "slug": "tron",
    "name": "Tron"
  }
}
POST
/api/v1/tokens
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Session token. Mobile/services. The web uses a cookie.

Session token. Mobile/services. The web uses a cookie.
API Key (cookie: session_token)
session_tokenstring
Required

API key (sent in cookie)

Content-Typestring
Required

The media type of the request body

Options: application/json
networkCodestring
Required

Network code from the Networks registry

contractAddressstring

Required for smart contract tokens; forbidden for native coins

decimalsinteger
Required
Min: 0 • Max: 38
isNativeboolean

default false

logoUristring

Link to the token's logo image

Format: uri • Max length: 2048
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Session token. Mobile/services. The web uses a cookie.

path
parameterstring
Required

API Key for authentication. Provide your API key in the cookie.

Body

application/json
codestring
Required
Example:
usdt
namestring
Required
Example:
Tether USD
networkCodestring
Required

Network code from the Networks registry

Example:
tron_network
contractAddressstring

Required for smart contract tokens; forbidden for native coins

Example:
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
isNativeboolean

default false

logoUristring

Link to the token's logo image

Example:
https://cdn.example.com/tokens/usdt.png

Responses