ThreatScan API V2

Tag a webhook

POST api.solidityscan.com/api-tag-webhook/

This endpoint allows users to register a webhook URL where SolidityScan will send notifications regarding the status of various scans and events. By tagging an endpoint, users can ensure they receive updates directly to their specified URL.

Headers

Name	Value
Content-Type	application/json
Authorization	Token <token>

Body

Name	Type	Description
endpoint_url*	string	The URL where SolidityScan will send event notifications.
endpoint_headers	json	Any headers you supply will be added to the request headers for the requested endpoint.

Response

200

{
    "status": "success",
    "message": "Endpoint successfully tagged."
}

400

{
  "error": "Invalid request"
}

Example

Curl

curl --location 'https://api.solidityscan.com/api-tag-webhook/' \
--header 'Authorization: Token <Your Token>' \
--header 'Content-Type: application/json' \
--data '{
    "endpoint_url": "<Your EndPoint URL>",
    "endpoint_headers": {
        "api_key": "val_xyz"
    }
}'

Python

import requests
import json

url = "https://api.solidityscan.com/api-tag-webhook/"

payload = json.dumps({
  "endpoint_url": "<Your EndPoint URL>"
})
headers = {
  'Authorization': 'Token <Your Token>',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Initiate New Scan

GETapi.solidityscan.com/api/v2/threatscan/{contract_platform}/{contract_chain}/{contract_address}

This endpoint initiates a new scan for a specified smart contract deployed on an EVM chain. Users need to provide the platform (e.g., etherscan), the chain (e.g., mainnet), and the contract address. Once the scan is initiated, its status and events will be pushed to the registered webhook URL.

Headers

Name	Value
Authorization	Token <token>

Response

200

{
    "data": "Request is being processed. Events will be pushed on endpoints configured",
    "scan_id": "de2bc482ff316c0b",
    "scan_status": "initialised",
    "contract_address": "0x8f9b4525681F3Ea6E43b8E0a57BFfF86c0A1dd2e",
    "contract_platform": "etherscan",
    "contract_chain": "mainnet",
    "request_uuid": "7f91377334a2594d2c8d74cb25316993",
    "status": "success"
}

400

{
    "status": "failed",
    "message": "Contract address validation failed"
}

Example

Curl

curl --location 'https://api.solidityscan.com/api/v2/threatscan/etherscan/mainnet/0x4d1C297d39C5c1277964D0E3f8Aa901493664530' \
--header 'Authorization: Token <Your Token>'

Python

import requests

url = "https://api.solidityscan.com/api/v2/threatscan/etherscan/mainnet/0x4d1C297d39C5c1277964D0E3f8Aa901493664530"

payload = {}
headers = {
  'Authorization': 'Token <Your Token>'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

After submitting a request, you will receive events on the webhook. Once the scan is complete, you will receive a response similar to the one below:

49KB

response.json