Documentation

Welcome to PulseChain API - a powerful REST API for block, gas, PLS price data. There is currently no API key requirement at this time.

Base URL

Endpoint 
https://pls.aff.icu/api

Network

View the most recent recorded network summary.

GET
/network
All gas suggestions and network stats
⌄

Example Request

cURL 
curl -X GET "https://pls.aff.icu/api/network" \
  -H "Content-Type: application/json"

Response

200 OK
JSON 
{
  "genesis_block": 17233000,
  "latest_block": 23891879,
  "slow": 921036686894971,
  "medium": 943348048438268,
  "fast": 1079215716921447,
  "base_fee": 1063554357499122,
  "slow_priority": 161318083414627,
  "medium_priority": 190264616966650,
  "fast_priority": 212816321526356,
  "plsusd_rate": 0.000024430332595199,
  "daily_tx": 443679,
  "average_block_utilization": 49.42,
  "average_block_size": 16091,
  "average_block_time": 10,
  "timestamp": 1751583665
}

Blocks

Get basic block details such as Byte Size, Total TX, Gas Used, Gas Limit, Base Fee, Timestamp

GET
/blocks
Block details
⌄

Query Parameters

Parameter Type Required Description
from integer Starting block
to integer Ending block
limit integer Number of blocks to fetch. Default: 20 (max 100)
offset integer Number of blocks to offset before limiting
blocks integer Comma separated list of block numbers to fetch
orderBy string ASC or DESC. Default: DESC

Example Request

cURL 
curl -X GET "https://pls.aff.icu/api/blocks?limit=5" \
  -H "Content-Type: application/json"

Response

200 OK
JSON 
[
    {
      "block_number": 23891879,
      "bytes": 18541,
      "tx": 33,
      "gas_used": 11635260,
      "gas_limit": 30000000,
      "base_fee": 1063554357499122,
      "timestamp": 1751583665
    },
    {
      "block_number": 23891878,
      "bytes": 11424,
      "tx": 20,
      "gas_used": 6635553,
      "gas_limit": 30000000,
      "base_fee": 1143242627193279,
      "timestamp": 1751583655
    },
    {
      "block_number": 23891877,
      "bytes": 18243,
      "tx": 37,
      "gas_used": 17705435,
      "gas_limit": 30000000,
      "base_fee": 1118036175522246,
      "timestamp": 1751583645
    },
    {
      "block_number": 23891876,
      "bytes": 72662,
      "tx": 133,
      "gas_used": 23630601,
      "gas_limit": 30000000,
      "base_fee": 1043020401208182,
      "timestamp": 1751583635
    },
    {
      "block_number": 23891875,
      "bytes": 8139,
      "tx": 12,
      "gas_used": 3452901,
      "gas_limit": 30000000,
      "base_fee": 1154071924226184,
      "timestamp": 1751583625
    }
]

Gas Price

Pre-generated gas prices based on historical block data for legacy and EIP1559 transactions

GET
/gas-prices
Historical gas price suggestions
⌄

Query Parameters

Parameter Type Required Description
type string Legacy or EIP1559. Default: Legacy
from integer Starting block
to integer Ending block
limit integer Number of blocks to fetch. Default: 20 (max 100)
offset integer Number of blocks to offset before limiting
blocks integer Comma separated list of block numbers to fetch
orderBy string ASC or DESC. Default: DESC

Example Request

cURL 
curl -X GET "https://pls.aff.icu/api/gas-prices?limit=5"

Response

200 OK
JSON 
[
    {
      "block_number": 23892917,
      "slow": 1172317844512523,
      "medium": 1209426530133418,
      "fast": 1412424931567212,
      "timestamp": 1751593985
    },
    {
      "block_number": 23892916,
      "slow": 1172317844512523,
      "medium": 1209426530133418,
      "fast": 1392420532937396,
      "timestamp": 1751594195
    },
    {
      "block_number": 23892915,
      "slow": 1172317844512523,
      "medium": 1209426530133418,
      "fast": 1392420532937396,
      "timestamp": 1751594185
    },
    {
      "block_number": 23892914,
      "slow": 1172317844512523,
      "medium": 1209426530133418,
      "fast": 1392420532937396,
      "timestamp": 1751594175
    },
    {
      "block_number": 23892913,
      "slow": 1172317844512523,
      "medium": 1209426530133418,
      "fast": 1392420532937396,
      "timestamp": 1751594165
    }
  ]

PLS/USD Price

Historical price data for PLS based on the WPLS/eDAI pair

GET
/plsusd-prices
Historical PLS/USD price
⌄

Query Parameters

Parameter Type Required Description
from integer Starting block
to integer Ending block
limit integer Number of blocks to fetch. Default: 20 (max 100)
offset integer Number of blocks to offset before limiting
blocks integer Comma separated list of block numbers to fetch
orderBy string ASC or DESC. Default: DESC

Example Request

cURL 
curl -X GET "https://pls.aff.icu/api/usd-prices?limit=5"

Response

200 OK
JSON 
[
    {
      "block_number": 23892895,
      "plsusd_rate": 0.000024683876247623,
      "timestamp": 1751593985
    },
    {
      "block_number": 23892894,
      "plsusd_rate": 0.000024685523033738,
      "timestamp": 1751593975
    },
    {
      "block_number": 23892893,
      "plsusd_rate": 0.000024685523033738,
      "timestamp": 1751593965
    },
    {
      "block_number": 23892892,
      "plsusd_rate": 0.000024688078720226,
      "timestamp": 1751593955
    },
    {
      "block_number": 23892891,
      "plsusd_rate": 0.000024679823917842,
      "timestamp": 1751593945
    },
  ]

Combined Price

Returns gas price for both transaction types and the PLS/USD price for requested blocks

GET
/prices
Gas Price + PLS/USD Price
⌄

Query Parameters

Parameter Type Required Description
from integer Starting block
to integer Ending block
limit integer Number of blocks to fetch. Default: 20 (max 100)
offset integer Number of blocks to offset before limiting
blocks integer Comma separated list of block numbers to fetch
orderBy string ASC or DESC. Default: DESC

Example Request

cURL 
curl -X GET "https://pls.aff.icu/api/prices?limit=5"

Response

200 OK
JSON 
[
    {
      "block_number": 23892949,
      "slow": 1214631680822651,
      "medium": 1375119502246283,
      "fast": 2069824334408565,
      "base_fee": 3196836672440663,
      "slow_priority": 28862763970502,
      "medium_priority": 452718403910320,
      "fast_priority": 889638174037484,
      "plsusd_rate": 0.000024701988797029,
      "timestamp": 1751593945
    },
    {
      "block_number": 23892948,
      "slow": 1214631680822651,
      "medium": 1375119502246283,
      "fast": 2068265115255104,
      "base_fee": 2843868299522281,
      "slow_priority": 345847551255267,
      "medium_priority": 501211485770887,
      "fast_priority": 937711695792169,
      "plsusd_rate": 0.000024700873571849,
      "timestamp": 1751594525
    },
    {
      "block_number": 23892947,
      "slow": 1214631680822651,
      "medium": 1375119502246283,
      "fast": 2062760522072553,
      "base_fee": 2965097883151311,
      "slow_priority": 330286179985234,
      "medium_priority": 531544019631139,
      "fast_priority": 919544206316723,
      "plsusd_rate": 0.000024700462489309,
      "timestamp": 1751594515
    },
    {
      "block_number": 23892946,
      "slow": 1214631680822651,
      "medium": 1347783506454808,
      "fast": 2057471645969982,
      "base_fee": 3215564237597060,
      "slow_priority": 20501702213431,
      "medium_priority": 420736320119750,
      "fast_priority": 838424026855432,
      "plsusd_rate": 0.000024706512799923,
      "timestamp": 1751594505
    },
    {
      "block_number": 23892945,
      "slow": 1214631680822651,
      "medium": 1316596068392184,
      "fast": 2043568391201154,
      "base_fee": 3181577145789733,
      "slow_priority": 35881149396981,
      "medium_priority": 425405318863631,
      "fast_priority": 684739887155525,
      "plsusd_rate": 0.000024706512799923,
      "timestamp": 1751594495
    }
  ]

RPC Servers

RPC servers and basic data such as Status, Latency, Latest Block, Pending TX

GET
/rpc-servers
Ranked by Latest Block and Latency
⌄

Query Parameters

Parameter Type Required Description
status string Online or Offline. Default: Both

Example Request

cURL 
curl -X GET "https://pls.aff.icu/api/rpc-servers"

Response

200 OK
JSON 
[
    {
      "url": "https://rpc-pulsechain.g4mm4.io",
      "status": "online",
      "latest_block": 23892621,
      "latency_ms": 126,
      "pending_tx": 93
    },
    {
      "url": "https://rpc.dysnomia.icu",
      "status": "online",
      "latest_block": 23892621,
      "latency_ms": 153,
      "pending_tx": 97
    },
    {
      "url": "https://rpc-pulsechain.g4mm4.io",
      "status": "online",
      "latest_block": 23892621,
      "latency_ms": 163,
      "pending_tx": 13811
    },
    {
      "url": "https://rpc-pulsechain.g4mm4.io",
      "status": "online",
      "latest_block": 23892619,
      "latency_ms": 122,
      "pending_tx": 81
    }
  ]

EVM Solc Compatibility

List is compiled from manually testing each EVM version against each Solc version

GET
/evm-solc
EVM Solc Compatibility
⌄

Query Parameters

Parameter Type Required Description
versions string Comma separated list of EVM versions

Example Request

cURL 
curl -X GET "https://pls.aff.icu/api/evm-solc?versions=cancun,prague"

Response

200 OK
JSON 
{
  "prague": [
      "0.8.27",
      "0.8.28",
      "0.8.29",
      "0.8.30"
  ],
  "cancun": [
      "0.8.24",
      "0.8.25",
      "0.8.26",
      "0.8.27",
      "0.8.28",
      "0.8.29",
      "0.8.30"
  ]
}

Error Handling

PulseChain API uses conventional HTTP response codes to indicate the success or failure of an API request.

HTTP Status Codes

Code Status Description
200 OK Everything worked as expected
400 Bad Request The request was unacceptable, often due to missing parameters
404 Not Found The requested resource doesn't exist
429 Too Many Requests Rate limit exceeded

Error Response Format

JSON 
{
    "error": "message"
}