Tok{In} API (beta)

The Tok{In} API offers an array of features that can help determine on whether a token is malicious or not. From storage checks, to simulation and static analsysis features. In its current form the Tok{In} API supports all ERC20 contracts on Ethereum, with more chains coming soon. The features are across all Uniswap V2/V3 and Aerodrome V2(Base) pools with V4 support coming soon.

Usage

curl -X 'GET' \
'https://tokin.dedaub.com/token/{chain}/{token_address}' \
-H 'accept: application/json' \
-H 'X-API-Key: YOUR-API-KEY'

chain: The chain of the token token_address: The address of the token

User Interface

A Swagger UI for easier interraction with the API is available at https://tokin.dedaub.com .

Response Formats

The Tok{In} API supports multiple response formats via the response_format query parameter.

Available Formats

Format	Description
`dedaub`	Default format
`goplus`	GoPlus-compatible format

Usage

# Default (Dedaub format)
GET /token/{chain}/{token_address}

# GoPlus format
GET /token/{chain}/{token_address}?response_format=goplus

GoPlus Format Mapping

The GoPlus format transforms the default tokin schema to a GoPlus compatible one, with the following caveats.

Direct Mappings

Dedaub Field	GoPlus Field	Notes
`is_open_source`	`is_open_source`	Boolean → "1"/"0" string
`is_proxy`	`is_proxy`	Boolean → "1"/"0" string
`mint_or_burn_function`	`is_mintable`	Boolean → "1"/"0" string
`owner_address`	`owner_address`	Direct string
`can_selfdestruct`	`selfdestruct`	Boolean → "1"/"0" string
`external_call`	`external_call`	Boolean → "1"/"0" string
`is_in_dex`	`is_in_dex`	Boolean → "1"/"0" string
`receive_tax`	`buy_tax`	Decimal as string
`send_tax`	`sell_tax`	Decimal as string
`cannot_buy`	`cannot_buy`	Boolean → "1"/"0" string
`tax_can_be_modified`	`slippage_modifiable`	Boolean → "1"/"0" string
`trading_cooldown`	`trading_cooldown`	Boolean → "1"/"0" string
`creator_address`	`creator_address`	Direct string
`creator_percent`	`creator_percent`	Decimal as string

Computed Mappings

GoPlus Field	Derived From	Logic
`transfer_pausable`	`cannot_buy`, `pause_status_can_be_modified`	`True` if either is `True`
`is_blacklisted`	`has_blacklist_or_whitelist`	Same value (temporary)
`is_whitelisted`	`has_blacklist_or_whitelist`	Same value (temporary)
`is_anti_whale`	`has_trading_cap`, `has_position_cap`	`True` if either is `True`
`anti_whale_modifiable`	`trading_cap_can_be_modified`, `position_cap_can_be_modified`	`True` if either is `True`

Fields Without Direct Equivalent (returns `null`)

GoPlus Field	Reason
`hidden_owner`	Not currently tracked
`cannot_sell_all`	Not currently tracked
`can_take_back_ownership`	Not currently tracked
`owner_change_balance`	Not currently tracked
`gas_abuse`	Not currently tracked
`personal_slippage_modifiable`	Not currently tracked
`lp_total_supply`	Not currently tracked
`is_airdrop_scam`	Not currently tracked
`trust_list`	Not currently tracked
`launchpad_token`	Not currently tracked

Caveats

is_blacklisted / is_whitelisted: Currently both map from has_blacklist_or_whitelist. We cannot distinguish between blacklist-only, whitelist-only, or both.
Boolean Format: GoPlus uses string format ("1" / "0") instead of booleans. All boolean fields are converted accordingly.
Tax Terminology: Our send_tax maps to GoPlus sell_tax, and our receive_tax maps to GoPlus buy_tax.

Available Chains

The available chains are: ethereum, binance, arbitrum, base and avalance. DEX coverage is most complete on Ethereum, with more pools being added to the other chains over time.

Static Analysis Features

We leverage the Gigahorse decompiler to analyze contracts whose source code is unavailable. The decompiled bytecode is checked for patterns commonly associated with undesirable behaviors in ERC20 tokens.

mint_or_burn_function:

There is a public function that changes the token’s total supply

selfdestruct:

The contract contains a selfdestruct call. (Note: The EVM no longer supports the SELFDESTRUCT opcode, so this is now a no-op.)

trading_cooldown:

An address must wait for a certain period after its last transfer before it can transfer tokens again.

view_function_modifies_state:

A function with the signature of one of the view functions defined by EIP-20 updates a storage variable.

has_trading_cap:

The amount of tokens transferred by a single call to transfer cannot exceed a value, either constant or held in storage.

has_trading_cap_functionality:

There is code that could enforce a trading cap. This can be true even if the cap is disabled.

trading_cap_can_be_modified:

The transfer amount cap is held in storage and there is function that can update it.

has_position_cap:

The amount of tokens an address can hold cannot exceed a value, either constant or held in storage.

position_cap_can_be_modified:

The position cap is held in storage and there is function that can update it.

has_position_cap_functionality:

There is code that could enforce a position cap. This can be true even if the cap is disabled.

has_owner_functionality:

There is functionality that could let one or more addresses have access to functionality of the token that the rest do not. This can be true even if the owner has been renounced.

owner_address

The address of the owner.

has_pause_functionality:

The token has code that could pause trading. Can be true even if the current state of the contract does not allow pausing functionality to be re-enabled.

pause_status_can_be_modified

The pause status can be changed in the future.

has_blacklist_or_whitelist:

Addresses can be restricted from trading the token.

external_call:

There is a call to another contract, whose target is not statically known and/or returns arbitrary data that are used by the token.

timebomb:

Certain functionality is only enabled after a specific timestamp.

has_tax_functionality:

This token has a tax functionality implemented. This could be true even if the current tax is 0 as the taxes could have been wiped.

tax_can_be_modified:

Tax value can be updated.

is_open_source:

This indicates whether the contract's source code is available.

is_proxy:

Indicates if the contract is a proxy contract.

Simulation Features

transfer_tax

send_tax (%): Calculated as the percentage loss from the sender's balance — e.g., if the sender sent 100 tokens and 110 were deducted, the send tax is 10%.
receive_tax (%): Calculated as the percentage the recipient received — e.g., if the sender sent 100 tokens and the recipient only received 90, the receive tax is 10%.
All values are expressed as percentages (e.g., 0.0 means 0%).

dex

An array of liquidity pools (Uniswap V2/V3 forks and Aerodrome V2 in Base) where the token is paired with WETH, USDC, or USDT, along with details on liquidity and trading behavior.

{
  "pair": "0x...",
  "liquidity_type": "UniV2" | "UniV3",
  "liquidity": 2455608.22,
  "buy_success": true,
  "buy_tax": 0.0,
  "sell_success": true,
  "sell_tax": 0.0,
  "errorMessage": null,
  "errorCode": null
}

pair: Address of the liquidity pair.
liquidity_type: Type of the pool. UniV2 = Uniswap V2 or compatible fork; UniV3 = Uniswap V3 or compatible fork; Solidly = Aerodrome (more Solidly forks coming!).
liquidity: USD value of the pool's known-token reserves:
- Estimated using balanceOf() on the known token — while not exact, it is a practical approximation that serves as a useful indicator of pool health and liquidity status.
buy_success: Whether buying the token (e.g., WETH -> token) succeeded during simulation.
buy_tax (%): Tax incurred on a buy.
sell_success: Whether selling the token succeeded.
sell_tax (%): Tax incurred on a sell.
errorMessage / errorCode: Populated for failed queries (e.g., low liquidity, failed swaps).

is_liquid:

This boolean indicates if the token is liquid, i.e. if at least one pool has more than $100 (in weth/usdc/usdt) value in it.

Notes on `liquidity`

For V2 pools, using the known token side (e.g., WETH in WETH/XYZ) is reliable since the reserves are fixed.
For V3 pools, the balanceOf() method on the known token offers a fast heuristic to assess pool liquidity. While it has some limitations — such as including uncollected fees or dust and not reflecting active price ranges — it still provides a strong signal of pool activity and health. In most cases, very low balances are a reliable indicator of illiquidity or abandoned pools.

Other features

name

Name of the token.

symbol

Symbol of the token.

supply

Total supply of the token.

normalized_supply

Total supply of the token adjusted for decimals.

creator_address

Address of the creator of the token.

creator_balance

Amount of tokens held by the creator.

creator_percent

Percentage of the total supply held by the creator of the token.

is_in_dex

The token has is in at least one DEX.

cannot_buy

Returns true if the token cannot be bought through any of the listed pools or if all the pools are too illiquid (less than $100).

Example

curl -X 'GET' \
'https://tokin.dedaub.com/token/ethereum/0x2328434559f7dec44373822cf68052de0d671b7f' \
-H 'accept: application/json' \
-H 'X-API-Key: YOUR-API-KEY'

Result:

{
  "chain": "ethereum",
  "contract_address": "0x2328434559f7dec44373822cf68052de0d671b7f",
  "features": {
    "mint_or_burn_function": true,
    "can_selfdestruct": false,
    "transfer_guarded_by_storage": true,
    "transfer_from_guarded_by_storage": true,
    "trading_cooldown": false,
    "view_function_modifies_state": false,
    "has_blacklist_or_whitelist": true,
    "external_call": true,
    "timebomb": true,
    "has_pause_functionality": true,
    "pause_status_can_be_modified": false,
    "has_owner_functionality": true,
    "has_tax_functionality": true,
    "tax_can_be_modified": false,
    "has_trading_cap_functionality": true,
    "trading_cap_can_be_modified": false,
    "has_position_cap_functionality": true,
    "position_cap_can_be_modified": false,
    "balance_update_function": [
      "0xa9059cbb",
      "0xa9059cbb",
      "0x23b872dd",
      "0x23b872dd",
      "0xa9059cbb",
      "0xa9059cbb",
      "0x23b872dd",
      "0x23b872dd",
      "0xa9059cbb",
      "0x23b872dd",
      "0xa9059cbb",
      "0xa9059cbb",
      "0x23b872dd",
      "0x23b872dd",
      "0xa9059cbb",
      "0xa9059cbb",
      "0x23b872dd",
      "0x23b872dd",
      "0xcd05e4ad",
      "0xa9059cbb",
      "0xa9059cbb",
      "0x23b872dd",
      "0x23b872dd",
      "0x3bd5d173"
    ],
    "allowance_update_function": [
      "0xa9059cbb",
      "0x23b872dd",
      "0x39509351",
      "0xa457c2d7",
      "0x95ea7b3"
    ],
    "name": "Simon the Gator",
    "symbol": "SIMON",
    "supply": 690000000000000000,
    "is_open_source": true,
    "is_liquid": true,
    "is_proxy": true,
    "owner_address": "0x0000000000000000000000000000000000000000",
    "send_tax": 0,
    "receive_tax": 1,
    "creator_address": "0x9cb1a958ad57f59a91582b81ac88378c1c12ee58",
    "creator_balance": 400000,
    "creator_percent": 0,
    "is_in_dex": true,
    "cannot_buy": false,
    "has_trading_cap": true,
    "has_position_cap": false,
    "dex": [
      {
        "errorMessage": null,
        "errorCode": null,
        "pair": "0xa954213fb0F410c8f1b2fca9B65F11A63ab3fFdb",
        "liquidity_type": "UniV2",
        "liquidity": 59292.7097022566,
        "buy_success": true,
        "buy_tax": 1,
        "sell_success": true,
        "sell_tax": 1,
        "pool_id": null
      }
    ]
  },
  "error": ""
}

Tok{In} API (beta)

Usage​

User Interface​

Response Formats​

Available Formats​

Usage​

GoPlus Format Mapping​

Direct Mappings​

Computed Mappings​

Fields Without Direct Equivalent (returns null)​

Caveats​

Available Chains​

Static Analysis Features​

mint_or_burn_function:​

selfdestruct:​

trading_cooldown:​

view_function_modifies_state:​

has_trading_cap:​

has_trading_cap_functionality:​

trading_cap_can_be_modified:​

has_position_cap:​

position_cap_can_be_modified:​

has_position_cap_functionality:​

has_owner_functionality:​

owner_address​

has_pause_functionality:​

pause_status_can_be_modified​

has_blacklist_or_whitelist:​

external_call:​

timebomb:​

has_tax_functionality:​

tax_can_be_modified:​

is_open_source:​

is_proxy:​

Simulation Features​

transfer_tax​

dex​

is_liquid:​

Notes on liquidity​

Other features​

name​

symbol​

supply​

normalized_supply​

creator_address​

creator_balance​

creator_percent​

is_in_dex​

cannot_buy​

Example​

Usage

User Interface

Response Formats

Available Formats

Usage

GoPlus Format Mapping

Direct Mappings

Computed Mappings

Fields Without Direct Equivalent (returns `null`)

Caveats

Available Chains

Static Analysis Features

mint_or_burn_function:

selfdestruct:

trading_cooldown:

view_function_modifies_state:

has_trading_cap:

has_trading_cap_functionality:

trading_cap_can_be_modified:

has_position_cap:

position_cap_can_be_modified:

has_position_cap_functionality:

has_owner_functionality:

owner_address

has_pause_functionality:

pause_status_can_be_modified

has_blacklist_or_whitelist:

external_call:

timebomb:

has_tax_functionality:

tax_can_be_modified:

is_open_source:

is_proxy:

Simulation Features

transfer_tax

dex

is_liquid:

Notes on `liquidity`

Other features

name

symbol

supply

normalized_supply

creator_address

creator_balance

creator_percent

is_in_dex

cannot_buy

Example