PulseChain Security Scanner API

Integrate our powerful token security analysis tools directly into your applications.

API Overview

Our REST API provides programmatic access to the PulseChain Security Scanner's functionality, allowing developers to integrate advanced security analysis into their own applications, trading platforms, or monitoring tools.

Base URL

https://api.pulsechain-scanner.com/v1

Authentication

All API requests require an API key passed in the X-API-KEY header.

Response Format

All endpoints return data in JSON format.

Endpoints

GET/analyze/pool/{poolAddress}

Analyze Pool Contract

Fetches information about a Uniswap V2 pool and returns details about both tokens in the pair.

Parameters

Parameter

Type

Description

poolAddress

string

The PulseChain address of the Uniswap V2 pool contract

Response

{
  "address": "0x1234...5678",
  "token0": {
    "address": "0xabcd...ef01",
    "symbol": "TOKEN",
    "name": "Example Token",
    "decimals": 18,
    "isStablecoin": false,
    "isWrappedNative": false
  },
  "token1": {
    "address": "0x2345...6789",
    "symbol": "WPLS",
    "name": "Wrapped PulseChain",
    "decimals": 18,
    "isStablecoin": false,
    "isWrappedNative": true
  },
  "needsTokenSelection": false
}

POST/analyze/token

Full Token Security Analysis

Performs a comprehensive security analysis on a specific token from a Uniswap V2 pool.

Request Body

{
  "poolAddress": "0x1234...5678",
  "tokenAddress": "0xabcd...ef01"
}

Response

{
  "poolAddress": "0x1234...5678",
  "selectedToken": {
    "address": "0xabcd...ef01",
    "symbol": "TOKEN",
    "name": "Example Token",
    "decimals": 18,
    "isStablecoin": false,
    "isWrappedNative": false
  },
  "pairToken": {
    "address": "0x2345...6789",
    "symbol": "WPLS",
    "name": "Wrapped PulseChain",
    "decimals": 18,
    "isStablecoin": false,
    "isWrappedNative": true
  },
  "isVerified": true,
  "overallRisk": "LOW",
  "buyTax": "2.0",
  "sellTax": "2.0",
  "hasDynamicFees": false,
  "highRiskFunctions": [],
  "aiAnalysis": {
    "summary": "This TOKEN contract follows standard practices...",
    "findings": [],
    "codeQualityScore": 85,
    "codeQualityAssessment": "The TOKEN code quality is good...",
    "vulnerabilityAssessment": "No significant vulnerabilities were identified...",
    "suspiciousPatterns": []
  }
}

Error Responses

Error Format

When an error occurs, the API will return an appropriate HTTP status code along with a JSON response containing error details.

{
  "error": {
    "code": "INVALID_ADDRESS",
    "message": "The provided address is not a valid PulseChain contract address",
    "status": 400
  }
}

Common Error Codes

Error Code

Status

Description

INVALID_ADDRESS

400

The provided address is not valid

CONTRACT_NOT_FOUND

404

The specified contract could not be found

NOT_UNISWAP_POOL

400

The address is not a Uniswap V2 pool

UNAUTHORIZED

401

Invalid or missing API key

Rate Limits

Usage Tiers

Plan	Requests/Minute	Requests/Day	Features
Free	5	100	Basic scanning
Standard	30	1,000	Full scanning + AI analysis
Enterprise	100	10,000	All features + custom integrations

Rate limit headers are included in all API responses:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 93
X-RateLimit-Reset: 1620000000

Try the API Playground

Test API calls and see live responses in our interactive playground.

API Playground