DogScan Logo
DogScan Logo

API Keys

Manage your API keys for programmatic access to DogScan services.

Please to manage your API keys.

API Documentation

Request

curl -X GET "https://api.dog.xyz/contracts/api_token_audits/1/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2" -H "X-API-Key: YOUR_API_KEY" -H "Content-Type:application-json"

Response



// Analysis in progress
{
  'status': 1,
  'findings': null
  'message': 'Analysis in progress'
}

// Analysis completed
{
  'status': 2,
  'findings': {
      'overall_risk_level': "Low Risk",
      'overall_risk_level_cn': "低风险",
      'risk_cn': {
          '费用盗窃风险': 0,
          '自毁风险': 0, 
          '税收操纵风险': 0, 
          '交易限制风险': 0, 
          '供应控制风险': 0, 
          '访问控制操纵风险': 0, 
          '交易停止风险': 0, 
          '可升级风险': 0, 
          '隐藏权限风险': 0, 
          '供应操纵风险': 0, 
          '交易完整性风': 0, 
          '外部依赖风险': 0
      }, 
      'risk_details_cn': {}, 
      'ai_summary_cn': '此合约为标准WETH实现,未发现安全风险或特权功能。所有操作均由用户自主控制,无管理员权限或隐藏机制。', 
      'risk': {
          'Fee Theft Risk': 0, 
          'Self-Destruction Risk': 0, 
          'Tax Manipulation Risk': 0, 
          'Trading Restrictions Risk': 0, 
          'Supply Control Risk': 0, 
          'Access Control Manipulation Risk': 0, 
          'Trading Halt Risk': 0, 
          'Upgradeable Risk': 0, 
          'Hidden Permissions Risk': 0, 
          'Supply Manipulation Risk': 0, 
          'Transaction Integrity Risk': 0, 
          'External Dependencies Risk': 0
      }, 
      'risk_details': {}, 
      'ai_summary': 'This contract is a standard WETH implementation with no identified security risks or privileged functions. All operations are user-controlled with no admin privileges or hidden mechanisms.', 
      'vulnerability_count': 0, 
      'highest_severity': 'none'
  }, 
  'message': 'Analysis completed'
}
  
// Contract is not verified
{
  'status': 3,
  'findings': null,
  'message': 'Contract is not verified'
}

Code


import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.dog.xyz"
# ETH Mainnet WETH
TOKEN = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"

# We support ETH Mainnet(1), BSC Mainnet(56), Base Mainnet(8453)
chainId = 1

def query_token(token_address):
  url = f"{BASE_URL}/contracts/api_token_audits/{chainId}/{token_address}"
  headers ={"X-API-Key": API_KEY}

  response = requests.get(url, headers=headers)
  response.raise_for_status()
  return response.json( ) 

token_info = query_token(TOKEN)
print(token_info)