TokenSniffer API

https://tokensniffer.readme.io/reference/
Admin
TokenSniffer API provides programmatic access to token security analysis, scam detection, and...
Tokens:30,541
Snippets:80
Trust Score:9.9
Update:11 months ago
Show doc for...
Tokens:
Raw
### List Supported Chains (JSON Response Example)

Source: https://tokensniffer.readme.io/reference/get-supported-networks

This code snippet displays an example JSON response when requesting a list of supported blockchains. It includes the total count of chains and an array of chain objects, each with an ID, name, and alias. This format is consistent across API calls for chain information.

```json
{
   "total":12,
   "result":[
      {
         "id":1,
         "name":"Ethereum",
         "alias":"eth"
      },
      {
         "id":10,
         "name":"Optimism",
         "alias":"opt"
      },
      {
         "id":25,
         "name":"Cronos",
         "alias":"cronos"
      },
      {
         "id":56,
         "name":"BNB Smart Chain",
         "alias":"bsc"
      },
      {
         "id":100,
         "name":"Gnosis",
         "alias":"xdai"
      },
      {
         "id": 101,
         "name": "Solana",
         "alias": "solana"
      },
      {
         "id":137,
         "name":"Polygon",
         "alias":"poly"
      },
      {
         "id":250,
         "name":"Fantom",
         "alias":"ftm"
      },
      {
         "id":321,
         "name":"KuCoin Community Chain",
         "alias":"kcc"
      },
      {
         "id":8453,
         "name":"Base",
         "alias":"base"
      },
      {
         "id":42161,
         "name":"Arbitrum",
         "alias":"arb"
      },
      {
         "id":42262,
         "name":"Oasis",
         "alias":"oasis"
      },
      {
         "id":43114,
         "name":"Avalanche",
         "alias":"avax"
      },
      {
        'id': 81457,
        'name': 'Blast',
        'alias': 'blast'
      },
      {
         "id":1666600000,
         "name":"Harmony",
         "alias":"harmony"
      }
   ]
}
```

--------------------------------

### GET /wallets/{address}

Source: https://tokensniffer.readme.io/reference/getting-started-with-your-api

Retrieves detailed information about a specific wallet address, including associated tokens and their properties.

```APIDOC
## GET /wallets/{address}

### Description
Retrieves detailed information about a specific wallet address, including associated tokens and their properties.

### Method
GET

### Endpoint
/wallets/{address}

### Parameters
#### Path Parameters
- **address** (string) - Required - The wallet address to query.

### Response
#### Success Response (200)
- **address** (string) - The wallet address.
- **name** (string) - The name of the token associated with the address.
- **symbol** (string) - The symbol of the token associated with the address.
- **rugpulls** (array) - An array of detected rug pulls for the token.

#### Response Example
```json
{
  "address": {
    "type": "string",
    "example": "0x578dec86ae6909e6d0b4c58064c74eb24e9fce0f"
  },
  "name": {
    "type": "string",
    "example": "The Yellow Emperor"
  },
  "symbol": {
    "type": "string",
    "example": "Huangdi"
  }
}
```
```

--------------------------------

### GET /api/v2/pairs/latest

Source: https://tokensniffer.readme.io/reference/getting-started-with-your-api

Retrieves the latest trading pairs created in the last 24 hours. This endpoint requires an API key and is available with the Enterprise plan.

```APIDOC
## GET /api/v2/pairs/latest

### Description
Get the latest trading pairs created in the last 24 hours. Available with the Enterprise plan.

### Method
GET

### Endpoint
https://tokensniffer.com/api/v2/pairs/latest

### Parameters
#### Query Parameters
- **apikey** (string) - Required - Your assigned API key
- **chain_id** (string) - Optional - Chain identifier
- **limit** (integer) - Optional - Maximum number of results. Defaults to 100 with a maximum of 5000.
- **offset** (integer) - Optional - Number of results to skip. Defaults to 0.
- **start_time** (string) - Optional - Restrict results to tokens created after this time
- **end_time** (string) - Optional - Restrict results to tokens created before this time

### Request Example
```json
{
  "apikey": "YOUR_API_KEY",
  "chain_id": "56",
  "limit": 100,
  "offset": 0,
  "start_time": "2025-04-03T21:10:06.000Z",
  "end_time": "2025-04-04T21:10:06.000Z"
}
```

### Response
#### Success Response (200)
- **message** (string) - Indicates the status of the request.
- **total** (integer) - The total number of results available.
- **result** (array) - An array of trading pair objects.
  - **chain_id** (string) - The ID of the blockchain.
  - **factory_address** (string) - The address of the liquidity factory.
  - **pair_address** (string) - The address of the trading pair.
  - **created_at** (string) - The timestamp when the pair was created.
  - **is_rugpull** (boolean) - Flag indicating if the token is identified as a rug pull.
  - **tokens** (array) - An array of token objects within the pair.
    - **address** (string) - The token's address.
    - **name** (string) - The token's name.
    - **symbol** (string) - The token's symbol.
  - **rugpulls** (array) - An array of rug pull details (if any).

#### Response Example
```json
{
  "message": "OK",
  "total": 5000,
  "result": [
    {
      "chain_id": "56",
      "factory_address": "0xca143ce32fe78f1f7019d7d551a6402fc5350c73",
      "pair_address": "0xaa91a50700441d3dda3fe5dc02ec2b9574c56cbb",
      "created_at": "2025-04-04T21:10:06.000Z",
      "is_rugpull": false,
      "tokens": [
        {
          "address": "0x578dec86ae6909e6d0b4c58064c74eb24e9fce0f",
          "name": "The Yellow Emperor",
          "symbol": "Huangdi"
        },
        {
          "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
          "name": "Wrapped BNB",
          "symbol": "WBNB"
        }
      ],
      "rugpulls": []
    }
  ]
}
```
```

--------------------------------

### Get Address Tokens

Source: https://tokensniffer.readme.io/reference/introduction

Retrieve a list of all scam tokens deployed by a specific wallet address, available for both Pro and Enterprise plan users.

```APIDOC
## GET /api/address/tokens

### Description
Get a list of scam tokens deployed by an address, if any.
Available in both the Pro and Enterprise subscription plans.

### Method
GET

### Endpoint
/api/address/tokens

### Parameters
#### Query Parameters
- **address** (string) - Required - The wallet address to check.
- **chain** (string) - Optional - Filter by a specific blockchain chain.
- **limit** (integer) - Optional - The maximum number of tokens to return.

### Request Example
```json
{
  "address": "0xdeployer123...",
  "chain": "eth",
  "limit": 5
}
```

### Response
#### Success Response (200)
- **tokens** (array) - A list of scam token objects deployed by the address.

#### Response Example
```json
{
  "tokens": [
    {
      "address": "0xscam1...",
      "name": "Scam Coin 1",
      "symbol": "SC1",
      "chain": "eth",
      "deployed_at": "2023-10-26T15:00:00Z"
    },
    ...
  ]
}
```
```

--------------------------------

### GET /websites/tokensniffer_readme_io_reference

Source: https://tokensniffer.readme.io/reference/get-malicious-addresses

Fetches a list of deployer addresses associated with scam tokens deployed in the past 24 hours. This is a premium endpoint requiring an Enterprise plan.

```APIDOC
## GET /websites/tokensniffer_readme_io_reference

### Description
Retrieves a list of addresses that have deployed known scam tokens within the last 24 hours. This feature is part of the Enterprise plan.

### Method
GET

### Endpoint
/websites/tokensniffer_readme_io_reference

### Parameters

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **message** (string) - Status message, "OK" on success.
- **total** (integer) - The total number of addresses returned.
- **result** (array) - An array of address descriptors.
  - **result.deployer_address** (string) - The address of the account that deployed scam contracts.
  - **result.flagged_contracts_count** (integer) - The number of scam contracts deployed by this address.
  - **result.reasons** (array) - A list of reasons why the contracts were flagged as scams.

#### Response Example
```json
{
  "message": "OK",
  "total": 2,
  "result": [
    {
      "deployer_address": "0x123...abc",
      "flagged_contracts_count": 3,
      "reasons": ["rug pull", "honeypot"]
    },
    {
      "deployer_address": "0xdef...456",
      "flagged_contracts_count": 1,
      "reasons": ["phishing"]
    }
  ]
}
```
```

--------------------------------

### Get Token API

Source: https://tokensniffer.readme.io/reference/api-response

Retrieves information about a specific token, including its scam status. Optionally includes metrics and test results.

```APIDOC
## GET /api/v1/tokens/{address}

### Description
Retrieves token information and scam status. When `include_metrics` or `include_tests` are set to true, it also includes detailed metrics and test results. Response times can vary depending on whether data needs to be refreshed.

### Method
GET

### Endpoint
`/api/v1/tokens/{address}`

### Parameters
#### Path Parameters
- **address** (string) - Required - The address of the token.

#### Query Parameters
- **include_metrics** (boolean) - Optional - If true, includes token metrics in the response.
- **include_tests** (boolean) - Optional - If true, includes test results for the token in the response.

### Request Example
```json
{
  "example": "GET /api/v1/tokens/0x123...abc?include_metrics=true"
}
```

### Response
#### Success Response (200)
- **token_info** (object) - Information about the token.
- **scam_status** (string) - The scam status of the token.
- **metrics** (object) - Optional - Detailed metrics about the token.
- **test_results** (object) - Optional - Results of tests performed on the token.

#### Response Example
```json
{
  "example": "{\"token_info\": {\"name\": \"Example Token\", \"symbol\": \"EXT\"}, \"scam_status\": \"none\", \"metrics\": {\"liquidity\": 1000000}, \"test_results\": {\"honeypot\": false}}"
}
```
```

--------------------------------

### Get Token

Source: https://tokensniffer.readme.io/reference/introduction

Retrieves detailed information about a specific token, including its source code, scam flags, on-chain metrics, and Smell Test results.

```APIDOC
## GET /api/token

### Description
Returns information about a token and its contract source code including whether the token was flagged as a scam. Optionally includes on-chain metrics (such as top holders and liquidity) and Smell Test results (including the token score).

### Method
GET

### Endpoint
/api/token

### Parameters
#### Query Parameters
- **address** (string) - Required - The contract address of the token.
- **chain** (string) - Optional - The blockchain chain the token is on (e.g., 'eth', 'bsc').
- **include_onchain_metrics** (boolean) - Optional - Whether to include on-chain metrics.
- **include_smell_test** (boolean) - Optional - Whether to include Smell Test results.

### Request Example
```json
{
  "address": "0xabc123...",
  "chain": "eth",
  "include_onchain_metrics": true,
  "include_smell_test": true
}
```

### Response
#### Success Response (200)
- **token_info** (object) - Detailed token information.
- **source_code** (string) - The token's source code.
- **is_scam** (boolean) - Whether the token is flagged as a scam.
- **onchain_metrics** (object) - On-chain metrics (if requested).
- **smell_test_results** (object) - Smell Test results (if requested).

#### Response Example
```json
{
  "token_info": {
    "name": "Example Token",
    "symbol": "EX",
    "decimals": 18
  },
  "source_code": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ncontract ExampleToken { ... }",
  "is_scam": false,
  "onchain_metrics": {
    "top_holders": [...],
    "liquidity": 1000000
  },
  "smell_test_results": {
    "score": 95,
    "analysis": "Looks good!"
  }
}
```
```

--------------------------------

### GET /scams

Source: https://tokensniffer.readme.io/reference/get-malicious-addresses

Retrieves a list of addresses that deployed scam tokens within the last 24 hours. This endpoint is available with the Enterprise plan and requires an API key.

```APIDOC
## GET /scams

### Description
Get the addresses that deployed a known scam token in the last 24 hours. Available with the Enterprise plan.

### Method
GET

### Endpoint
https://tokensniffer.com/api/v2/addresses/scams

### Parameters
#### Query Parameters
- **apikey** (string) - Required - Your assigned API key
- **chain_id** (string) - Optional - Chain identifier
- **limit** (integer) - Optional - Maximum number of results. Defaults to 100.
- **offset** (integer) - Optional - Number of results to skip. Defaults to 0.
- **start_time** (string) - Optional - Restrict results to tokens created/flagged before this time
- **end_time** (string) - Optional - Restrict results to tokens created/flagged after this time
- **deployer_address** (string) - Optional - Restrict results to token contracts deployed by given address

### Request Example
```json
{
  "message": "OK"
}
```

### Response
#### Success Response (200)
- **message** (string) - Status message, typically "OK"
- **total** (integer) - Total number of scam addresses found
- **result** (array) - An array of scam address objects
  - **deployer_address** (string) - The address that deployed the scam token
  - **flagged_contracts_count** (integer) - The number of flagged contracts associated with the deployer
  - **reasons** (array) - A list of reasons why the contracts were flagged

#### Response Example
```json
{
  "message": "OK",
  "total": 123,
  "result": [
    {
      "deployer_address": "0xffedc81da4270a378980b9936d27d488f8523a28",
      "flagged_contracts_count": 1,
      "reasons": [
        "malicious contract"
      ]
    }
  ]
}
```

#### Error Response (400)
- **message** (string) - A message describing the error

#### Error Response Example
```json
{
  "message": "reason"
}
```
```

--------------------------------

### Get Scam Tokens Deployed by Address

Source: https://tokensniffer.readme.io/reference/index

Retrieves a list of scam tokens that have been deployed by a specific address. This endpoint is available in both Pro and Enterprise plans.

```APIDOC
## GET /api/v2/addresses/{address}/tokens/scam

### Description
Get a list of scam tokens deployed by an address, if any.
Available in both the Pro and Enterprise subscription plans.

### Method
GET

### Endpoint
`/api/v2/addresses/{address}/tokens/scam`

### Parameters
#### Path Parameters
- **address** (string) - Required - The address of the deployer.

#### Query Parameters
- **chain** (string) - Optional - Filter by blockchain.
- **limit** (integer) - Optional - Number of tokens to return.
- **offset** (integer) - Optional - Number of tokens to skip.

### Request Example
```json
{
  "example": "GET /api/v2/addresses/0xDeployerAddress/tokens/scam?chain=bsc&limit=5"
}
```

### Response
#### Success Response (200)
- **tokens** (array) - A list of scam token objects deployed by the address.

#### Response Example
```json
{
  "example": {
    "tokens": [
      {
        "address": "0xScamTokenByDeployer",
        "name": "Deceptive Coin",
        "symbol": "DPC",
        "chain": "bsc"
      }
    ]
  }
}
```
```

--------------------------------

### GET /scams

Source: https://tokensniffer.readme.io/reference/get-malicious-tokens

Retrieves a list of scam tokens flagged within the last 24 hours. This endpoint is available with the Enterprise plan.

```APIDOC
## GET /scams

### Description
Get the scam tokens flagged in the last 24 hours. Available with the Enterprise plan.

### Method
GET

### Endpoint
https://tokensniffer.com/api/v2/tokens/scams

### Parameters
#### Query Parameters
- **apikey** (string) - Required - Your assigned API key
- **chain_id** (integer) - Optional - Chain identifier
- **limit** (integer) - Optional - Maximum number of results. Defaults to 100 with a maximum of 5000.
- **offset** (integer) - Optional - Number of results to skip. Defaults to 0.
- **start_time** (string) - Optional - Restrict results to tokens created/flagged after this time.
- **end_time** (string) - Optional - Restrict results to tokens created/flagged before this time.
- **deployer_address** (string) - Optional - Restrict results to token contracts deployed by given address

### Request Example
```json
{
  "apikey": "YOUR_API_KEY",
  "chain_id": 1,
  "limit": 10,
  "offset": 0,
  "start_time": "2022-12-15T00:00:00.000Z",
  "end_time": "2022-12-15T23:59:59.999Z",
  "deployer_address": "0x4cb35982daa6e27a4db10684ab486029a2e08476"
}
```

### Response
#### Success Response (200)
- **message** (string) - Status message, e.g., "OK"
- **total** (integer) - The total number of scam tokens found
- **result** (array) - An array of scam token objects
  - **chain_id** (integer) - The ID of the blockchain the token is on
  - **address** (string) - The contract address of the token
  - **name** (string) - The name of the token
  - **symbol** (string) - The symbol of the token
  - **deployer_address** (string) - The address that deployed the token contract
  - **created_at** (string) - The timestamp when the token was created/flagged
  - **is_source_verified** (boolean) - Indicates if the token's source code is verified
  - **exploits** (array) - A list of exploits associated with the token
    - **id** (integer) - The ID of the exploit
    - **name** (string) - The name of the exploit
    - **types** (array of strings) - The types of exploit

#### Response Example
```json
{
  "message": "OK",
  "total": 1,
  "result": [
    {
      "chain_id": 1,
      "address": "0x318c7d361d0a26c7ff8126a4b11ab65fdba8aa12",
      "name": "Frog Santa",
      "symbol": "FGS",
      "deployer_address": "0x4cb35982daa6e27a4db10684ab486029a2e08476",
      "created_at": "2022-12-15T04:05:15.719Z",
      "is_source_verified": true,
      "exploits": [
        {
          "id": 35,
          "name": "Hidden mint functionality #5",
          "types": [
            "fake ownership renounce", 
            "hidden mint"
          ]
        }
      ]
    }
  ]
}
```
```

--------------------------------

### List Malicious Addresses

Source: https://tokensniffer.readme.io/reference/introduction

Get a list of all wallet addresses that have deployed a scam token in the last 24 hours. This endpoint is exclusive to Enterprise plan subscribers.

```APIDOC
## GET /api/addresses/malicious

### Description
Get a list of all addresses that have deployed a scam token in the last 24 hour period.
Available only in Enterprise subscription plan.

### Method
GET

### Endpoint
/api/addresses/malicious

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - The maximum number of addresses to return.
- **chain** (string) - Optional - Filter by a specific blockchain chain.

### Request Example
```json
{
  "limit": 50,
  "chain": "bsc"
}
```

### Response
#### Success Response (200)
- **addresses** (array) - A list of addresses that deployed scam tokens.

#### Response Example
```json
{
  "addresses": [
    {
      "address": "0xmaliciousdeployer...",
      "deployed_scam_count": 3,
      "last_scam_deployment": "2023-10-27T09:00:00Z"
    },
    ...
  ]
}
```
```

--------------------------------

### OpenAPI Definition for Listing Chains

Source: https://tokensniffer.readme.io/reference/get-supported-networks

This snippet shows the OpenAPI 3.1.0 definition for the Chain API's endpoint to list supported chains. It outlines the GET request, its summary, description, and the structure of the successful 200 OK response, including the schema for the returned JSON.

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Chain API",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://tokensniffer.com/api/v2/chains"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/": {
      "get": {
        "summary": "List Supported Chains",
        "description": "Get a list of supported blockchains including chain IDs.  API key not required.",
        "operationId": "get-supported-networks",
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"total\": 12,\n  \"result\": [\n    {\n      \"id\": 1,\n      \"name\": \"Ethereum\",\n      \"alias\": \"eth\"\n    },\n    {\n      \"id\": 10,\n      \"name\": \"Optimism\",\n      \"alias\": \"opt\"\n    },\n    {\n      \"id\": 25,\n      \"name\": \"Cronos\",\n      \"alias\": \"cronos\"\n    },\n    {\n      \"id\": 56,\n      \"name\": \"BNB Smart Chain\",\n      \"alias\": \"bsc\"\n    },\n    {\n      \"id\": 100,\n      \"name\": \"Gnosis\",\n      \"alias\": \"xdai\"\n    },\n    {\n      \"id\": 137,\n      \"name\": \"Polygon\",\n      \"alias\": \"poly\"\n    },\n    {\n      \"id\": 250,\n      \"name\": \"Fantom\",\n      \"alias\": \"ftm\"\n    },\n    {\n      \"id\": 321,\n      \"name\": \"KuCoin Community Chain\",\n      \"alias\": \"kcc\"\n    },\n    {\n      \"id\": 42161,\n      \"name\": \"Arbitrum\",\n      \"alias\": \"arb\"\n    },\n    {\n      \"id\": 42262,\n      \"name\": \"Oasis\",\n      \"alias\": \"oasis\"\n    },\n    {\n      \"id\": 43114,\n      \"name\": \"Avalanche\",\n      \"alias\": \"avax\"\n    },\n    {\n      \"id\": 1666600000,\n      \"name\": \"Harmony\",\n      \"alias\": \"harmony\"\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "total": {
                      "type": "integer",
                      "example": 12,
                      "default": 0
                    },
                    "result": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 1,
                            "default": 0
                          },
                          "name": {
                            "type": "string",
                            "example": "Ethereum"
                          },
                          "alias": {
                            "type": "string",
                            "example": "eth"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "6399660d93e44d0070adfe4b:63996d0f589f9a083f1ae184"
}
```

--------------------------------

### GET /scams/tokens

Source: https://tokensniffer.readme.io/reference/list-tokens-with-malicious-pairs

Retrieves a list of tokens with pairs that have been identified as rug-pulled within the last 24 hours. This endpoint requires an Enterprise plan.

```APIDOC
## GET /scams/tokens

### Description
Get the tokens (excluding the quote token such as ETH, BNB, etc) for trading pairs which have been rugpulled in the last 24 hours. Available with the Enterprise plan.

### Method
GET

### Endpoint
https://tokensniffer.com/api/v2/pairs/scams/tokens

### Parameters
#### Query Parameters
- **apikey** (string) - Required - Your assigned API key
- **chain_id** (string) - Optional - Chain identifier
- **limit** (integer) - Optional - Maximum number of results. Defaults to 100 with a maximum of 5000.
- **offset** (integer) - Optional - Number of results to skip. Defaults to 0.
- **start_time** (string) - Optional - Restrict results to tokens created after this time
- **end_time** (string) - Optional - Restrict results to tokens created before this time

### Request Example
```json
{
  "apikey": "YOUR_API_KEY",
  "chain_id": "56",
  "limit": 100,
  "offset": 0,
  "start_time": "2023-10-27T00:00:00Z",
  "end_time": "2023-10-28T00:00:00Z"
}
```

### Response
#### Success Response (200)
- **message** (string) - API response message.
- **total** (integer) - The total number of rug-pulled tokens found.
- **result** (array) - An array of token objects that have been rug-pulled.
  - **address** (string) - The token's contract address.
  - **name** (string) - The token's name.
  - **symbol** (string) - The token's symbol.
  - **chain_id** (string) - The ID of the blockchain the token is on.
  - **rugpulls** (array) - An array of rug pull incidents for the token.
    - **category** (string) - The category of the rug pull (e.g., "swap").
    - **timestamp** (string) - The timestamp of the rug pull.
    - **tx_hash** (string) - The transaction hash of the rug pull.

#### Response Example
```json
{
  "message": "OK",
  "total": 1,
  "result": [
    {
      "address": "0x953e5cb1e053b3158166935aff287ffc7cf5984c",
      "name": "AIBRAIN",
      "symbol": "AIBRAIN",
      "chain_id": "56",
      "rugpulls": [
        {
          "category": "swap",
          "timestamp": "2025-04-04T21:06:06.000Z",
          "tx_hash": "0x3e7a79a5fe81499236f3dc8337004d68fcc5cc38cb2177ae481c0f9839ca0a08"
        }
      ]
    }
  ]
}
```
```

--------------------------------

### GET /scams

Source: https://tokensniffer.readme.io/reference/list-malicious-pairs

Retrieves a list of trading pairs that have been identified as rug pulls within the last 24 hours. This endpoint is available with the Enterprise plan.

```APIDOC
## GET /scams

### Description
Get the trading pairs which have been rugpulled in the last 24 hours. Available with the Enterprise plan.

### Method
GET

### Endpoint
https://tokensniffer.com/api/v2/pairs/scams

### Parameters
#### Query Parameters
- **apikey** (string) - Required - Your assigned API key
- **chain_id** (string) - Optional - Chain identifier
- **limit** (integer) - Optional - Maximum number of results. Defaults to 100 with a maximum of 5000.
- **offset** (integer) - Optional - Number of results to skip. Defaults to 0.
- **start_time** (string) - Optional - Restrict results to tokens created after this time
- **end_time** (string) - Optional - Restrict results to tokens created before this time

### Request Example
```json
{
  "apikey": "YOUR_API_KEY",
  "chain_id": "56",
  "limit": 10,
  "offset": 0,
  "start_time": "2025-04-01T00:00:00.000Z"
}
```

### Response
#### Success Response (200)
- **message** (string) - Indicates the status of the request, e.g., "OK".
- **total** (integer) - The total number of malicious pairs found.
- **result** (array) - An array of objects, where each object represents a malicious trading pair.
  - **chain_id** (string) - The identifier of the blockchain.
  - **factory_address** (string) - The address of the liquidity pool factory.
  - **pair_address** (string) - The address of the trading pair.
  - **created_at** (string) - The timestamp when the pair was created.
  - **is_rugpull** (boolean) - Indicates if the pair is a rug pull.
  - **tokens** (array) - An array of token objects involved in the pair.
    - **address** (string) - The token's contract address.
    - **name** (string) - The token's name.
    - **symbol** (string) - The token's symbol.
  - **rugpulls** (array) - An array of objects detailing the rug pull events.
    - **category** (string) - The type of rug pull (e.g., "swap").
    - **timestamp** (string) - The timestamp of the rug pull event.
    - **tx_hash** (string) - The transaction hash of the rug pull event.

#### Response Example
```json
{
  "message": "OK",
  "total": 1452,
  "result": [
    {
      "chain_id": "56",
      "factory_address": "0xca143ce32fe78f1f7019d7d551a6402fc5350c73",
      "pair_address": "0xc444deabb42cd9da642f7aa106fbb7f88b3e58ae",
      "created_at": "2025-04-04T21:06:03.000Z",
      "is_rugpull": true,
      "tokens": [
        {
          "address": "0x953e5cb1e053b3158166935aff287ffc7cf5984c",
          "name": "AIBRAIN",
          "symbol": "AIBRAIN"
        },
        {
          "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
          "name": "Wrapped BNB",
          "symbol": "WBNB"
        }
      ],
      "rugpulls": [
        {
          "category": "swap",
          "timestamp": "2025-04-04T21:06:06.000Z",
          "tx_hash": "0x3e7a79a5fe81499236f3dc8337004d68fcc5cc38cb2177ae481c0f9839ca0a08"
        }
      ]
    }
   ]
}
```
```

--------------------------------

### GET /websites/tokensniffer_readme_io_reference

Source: https://tokensniffer.readme.io/reference/get-address-results

Retrieves scam tokens associated with a given address. This endpoint provides counts of malicious contracts, a summary of scam categories, and detailed information about each scam contract deployed by the address.

```APIDOC
## GET /websites/tokensniffer_readme_io_reference

### Description
Retrieves scam tokens for a given address. This endpoint is available with the Pro and Enterprise plans.

### Method
GET

### Endpoint
/websites/tokensniffer_readme_io_reference

### Parameters
#### Query Parameters
- **address** (string) - Required - The address to query for scam tokens.

### Request Example
```json
{
  "address": "0x123..."
}
```

### Response
#### Success Response (200)
- **message** (string) - 'OK' if query succeeded, otherwise an error message.
- **malicious_contracts_count** (integer) - Total number of scam contracts deployed by the given address.
- **categories** (array) - Array of scam category descriptors.
  - **categories.name** (string) - Category name.
  - **categories.types** (string) - Category type.
  - **categories.count** (integer) - Number of tokens in category deployed by this address.
- **contracts** (array) - Array of scam contract descriptors.
  - **contracts.chainId** (integer) - Contract numeric chain identifier.
  - **contracts.address** (string) - Contract address.
  - **contracts.types** (array) - List of scam type strings.

#### Response Example
```json
{
  "message": "OK",
  "malicious_contracts_count": 5,
  "categories": [
    {
      "name": "Phishing",
      "types": "Rugpull",
      "count": 3
    },
    {
      "name": "Honeypot",
      "types": "Scan",
      "count": 2
    }
  ],
  "contracts": [
    {
      "chainId": 1,
      "address": "0xabc...",
      "types": ["Rugpull", "Scan"]
    },
    {
      "chainId": 56,
      "address": "0xdef...",
      "types": ["Rugpull"]
    }
  ]
}
```
```

--------------------------------

### List Tokens with Malicious Pairs

Source: https://tokensniffer.readme.io/reference/introduction

Get a list of tokens that are part of trading pairs identified as rugpulls within the last 24 hours. This endpoint is part of the Enterprise plan.

```APIDOC
## GET /api/tokens/malicious-pairs

### Description
Get the tokens for pairs which have rugpulled in the last 24 hour period.
Available only in Enterprise subscription plan.

### Method
GET

### Endpoint
/api/tokens/malicious-pairs

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - The maximum number of tokens to return.
- **chain** (string) - Optional - Filter by a specific blockchain chain.

### Request Example
```json
{
  "limit": 30,
  "chain": "polygon"
}
```

### Response
#### Success Response (200)
- **tokens** (array) - A list of token objects involved in malicious pairs.

#### Response Example
```json
{
  "tokens": [
    {
      "address": "0xmalictoken...",
      "name": "Rugged Token",
      "symbol": "RGT",
      "chain": "polygon",
      "involved_in_malicious_pair_at": "2023-10-27T07:45:00Z"
    },
    ...
  ]
}
```
```

--------------------------------

### API Error Response Example (JSON)

Source: https://tokensniffer.readme.io/reference/list-latest-tokens

Illustrates the structure of a 400 Bad Request error response from the Tokensniffer API. This response is typically returned for invalid input or malformed requests.

```json
{
  "400": {
    "description": "400",
    "content": {
      "application/json": {
        "examples": {
          "Result": {
            "value": "{}"
          }
        },
        "schema": {
          "type": "object",
          "properties": {}
        }
      }
    }
  }
}
```

--------------------------------

### Get Address API

Source: https://tokensniffer.readme.io/reference/api-response

Retrieves information associated with a specific address.

```APIDOC
## GET /api/v1/addresses/{address}

### Description
Retrieves information related to a given address.

### Method
GET

### Endpoint
`/api/v1/addresses/{address}`

### Parameters
#### Path Parameters
- **address** (string) - Required - The address to query.

### Request Example
```json
{
  "example": "GET /api/v1/addresses/0x123...abc"
}
```

### Response
#### Success Response (200)
- **address_info** (object) - Information about the address.

#### Response Example
```json
{
  "example": "{\"address_info\": {\"balance\": \"100 ETH\"}}"
}
```
```

--------------------------------

### GET /api/v2/tokens/corrections

Source: https://tokensniffer.readme.io/reference/list-corrected-tokens

Retrieves a list of tokens that have been un-flagged in the last 24 hours. This endpoint is available with the Enterprise plan.

```APIDOC
## GET /api/v2/tokens/corrections

### Description
Get the tokens which were un-flagged in the last 24 hours. Available with the Enterprise plan.

### Method
GET

### Endpoint
https://tokensniffer.com/api/v2/tokens/corrections

### Parameters
#### Query Parameters
- **apikey** (string) - Required - Your assigned API key
- **chain_id** (string) - Optional - Chain identifier
- **limit** (integer) - Optional - Maximum number of results. Defaults to 100 with a maximum of 5000.
- **offset** (integer) - Optional - Number of results to skip. Defaults to 0.
- **start_time** (string) - Optional - Restrict results to tokens created/flagged after this time.
- **end_time** (string) - Optional - Restrict results to tokens created/flagged before this time

### Request Example
```json
{
  "apikey": "YOUR_API_KEY",
  "chain_id": "1",
  "limit": 100,
  "offset": 0,
  "start_time": "2023-03-05T18:22:35.000Z",
  "end_time": "2023-03-06T18:22:35.000Z"
}
```

### Response
#### Success Response (200)
- **message** (string) - Indicates the status of the request.
- **total** (integer) - The total number of corrected tokens found.
- **result** (array) - An array of token objects.
  - **chain_id** (string) - The identifier for the blockchain.
  - **address** (string) - The token contract address.
  - **deployer_addr** (string) - The address of the token deployer.
  - **name** (string) - The name of the token.
  - **symbol** (string) - The symbol of the token.
  - **created_at** (string) - The timestamp when the token was created.
  - **unflagged_at** (string) - The timestamp when the token was un-flagged.
  - **is_source_verified** (boolean) - Indicates if the token's source code is verified.

#### Response Example
```json
{
  "message": "OK",
  "total": 36,
  "result": [
    {
      "chain_id": "1",
      "address": "0xf86f074d2230a2961499e7a7101cea291978d23f",
      "deployer_addr": "0xba059c8bebeeda8f000267b7ff066fe0595b3fd2",
      "name": "SHIBA INU CHAIN",
      "symbol": "SINU",
      "created_at": "2023-03-05T18:22:35.000Z",
      "unflagged_at": "2025-04-04T20:02:09.144Z",
      "is_source_verified": true
    }
  ]
}
```
```

--------------------------------

### Similar Contracts

Source: https://tokensniffer.readme.io/reference/response

Retrieve information about similar smart contracts by setting the `include_similar` query parameter to `true`. The response will include a `similar` array containing details about each matching contract.

```APIDOC
## GET /websites/tokensniffer_readme_io_reference

### Description
This endpoint, when queried with `include_similar=true`, returns a list of similar smart contracts. The `similar` array in the response contains objects detailing each similar contract found.

### Method
GET

### Endpoint
/websites/tokensniffer_readme_io_reference

### Parameters
#### Query Parameters
- **include_similar** (boolean) - Optional - Set to `true` to include similar contracts in the response.

### Request Example
```
GET /websites/tokensniffer_readme_io_reference?include_similar=true
```

### Response
#### Success Response (200)
- **similar** (array) - An array of objects, where each object represents a similar contract.
  - **chainID** (string) - Chain identifier for the similar contract.
  - **address** (string) - Address of the similar contract.
  - **score** (integer) - Similarity score from 0 to 100 (100 being identical).

#### Response Example
```json
{
  "similar": [
    {
      "chainID": "1",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "score": 95
    },
    {
      "chainID": "1",
      "address": "0abcdef1234567890abcdef1234567890abcdef12",
      "score": 80
    }
  ]
}
```
```

--------------------------------

### List Malicious Tokens

Source: https://tokensniffer.readme.io/reference/introduction

Obtain a list of all scam tokens deployed within the last 24 hours. This endpoint is exclusive to Enterprise plan users.

```APIDOC
## GET /api/tokens/malicious

### Description
Get a list of all scam tokens deployed in the last 24 hour period.
Available only in Enterprise subscription plan.

### Method
GET

### Endpoint
/api/tokens/malicious

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - The maximum number of tokens to return.
- **chain** (string) - Optional - Filter by a specific blockchain chain.

### Request Example
```json
{
  "limit": 20,
  "chain": "eth"
}
```

### Response
#### Success Response (200)
- **tokens** (array) - A list of malicious token objects.

#### Response Example
```json
{
  "tokens": [
    {
      "address": "0xbadcoin...",
      "name": "Scam Token",
      "symbol": "SCAM",
      "chain": "eth",
      "detected_at": "2023-10-27T09:30:00Z"
    },
    ...
  ]
}
```
```
Tokens:
Raw