ThreatScore 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
Content-Type
application/json
Authorization
Token <token>
Body
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
{
"status": "success",
"message": "Endpoint successfully tagged."
}
Example
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"
}
}'
Initiate New Scan
GET
api.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
Authorization
Token <token>
Response
{
"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"
}
Example
curl --location 'https://api.solidityscan.com/api/v2/threatscan/etherscan/mainnet/0x4d1C297d39C5c1277964D0E3f8Aa901493664530' \
--header 'Authorization: Token <Your Token>'
After submitting a request, you will receive events on the webhook. Once the scan is completed and a new request for the same token is sent, you will receive a response similar to this:
Note: No event will be pushed if the same contract is scanned again within 24 hours.
Last updated