Pepecoin API Documentation

The Peppool.space API provides programmatic access to Pepecoin blockchain data and market information.

All endpoints are rate-limited and return data in plain text or JSON format.

Base URL

https://peppool.space/api

Rate Limiting

All API endpoints are rate-limited to 60 requests per minute per IP address.

GET


            /blocks/tip/hash

Returns the hash of the current tip block of the Pepecoin blockchain.

Example

curl https://peppool.space/api/blocks/tip/hash

Response

Content-Type: text/plain

a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456

GET


            /blocks/tip/height

Returns the current block height of the Pepecoin blockchain.

Example

curl https://peppool.space/api/blocks/tip/height

Response

Content-Type: text/plain

672216

GET


            /blocks[/:startHeight]

Returns details on the past 10 blocks.
If :startHeight is specified, the 10 blocks before (and including) :startHeight are returned.

Example

curl https://peppool.space/api/blocks

curl https://peppool.space/api/blocks/600069

Response

Content-Type: application/json

[
  {
    "id": "0000000000000000000384f28cb3...",
    "height": 600069,
    "version": 1,
    "timestamp": 1648829449,
    "tx_count": 1627,
    "size": 1210916,
    "difficulty": 28587155.782195,
    "nonce": 3580664066,
    "merkle_root": "efa344bcd6c0607f93b7..."
  },
  {
    "id": "0000000000000000000a1b2c3d4e...",
    "height": 600068,
    "version": 1,
    "timestamp": 1648828850,
    "tx_count": 1432,
    "size": 1180421,
    "difficulty": 28587155.782195,
    "nonce": 1532048855,
    "merkle_root": "ab12cd34ef56ab78cd90..."
  },
  ...
]

Response Fields

Field	Type	Description
`id`	string	Block hash
`height`	integer	Block height
`version`	integer	Block version
`timestamp`	integer	Unix time the block was created
`tx_count`	integer	Number of transactions in the block
`size`	integer	Block size in bytes
`difficulty`	float	Current difficulty value for the block
`nonce`	integer	Nonce used for the block
`merkle_root`	string	Merkle root of the block

GET


            /mempool

Returns a summary of the current mempool state, including the number of transactions and total size in bytes.

Example

curl https://peppool.space/api/mempool

Response

Content-Type: application/json

{
  "count": 1245,
  "bytes": 1234567
}

Response Fields

Field	Type	Description
`count`	integer	Number of transactions in the mempool
`bytes`	integer	Total size of all transactions in the mempool in bytes

GET


            /mempool/txids

Returns an array of transaction IDs currently in the mempool.

Example

curl https://peppool.space/api/mempool/txids

Response

Content-Type: application/json

[
  "txid1...",
  "txid2...",
  "txid3..."
]

GET


            /mempool/recent

Returns a list of the last 10 transactions to enter the mempool. Each transaction object contains simplified overview data.

Example

curl https://peppool.space/api/mempool/recent

Response

Content-Type: application/json

[
  {
    "txid": "4b93c138293a7e3dfea6f0a63d944890b5ba571b03cc22d8c66995535e90dce8",
    "fee": 18277,
    "vsize": 2585,
    "value": 4972029
  },
  ...
]

Response Fields

Field	Type	Description
`txid`	string	Transaction ID
`fee`	integer	Transaction fee in ribbits
`vsize`	integer	Virtual size of the transaction
`value`	integer	Total output value in ribbits

GET


            /prices

Returns the latest Pepecoin prices.

Example

curl https://peppool.space/api/prices

Response

Content-Type: application/json

{
  "time": 1724263564,
  "EUR": 0.00000123,
  "USD": 0.00000134
}

Response Fields

Field	Type	Description
`time`	integer	Unix timestamp indicating when the price data was last refreshed
`EUR`	float	Latest price in Euro
`USD`	float	Latest price in US Dollar

GET


            /address/:address

Returns details about a Pepecoin address, including chain and mempool statistics.

Example

curl https://peppool.space/api/address/PumNFmkevCTG6RTEc7W2piGTbQHMg2im2M

Response

Content-Type: application/json

{
  "address": "PumNFmkevCTG6RTEc7W2piGTbQHMg2im2M",
  "chain_stats": {
    "funded_txo_count": 1,
    "funded_txo_sum": 100000000,
    "spent_txo_count": 0,
    "spent_txo_sum": 0,
    "tx_count": 1
  },
  "mempool_stats": {
    "funded_txo_count": 0,
    "funded_txo_sum": 0,
    "spent_txo_count": 0,
    "spent_txo_sum": 0,
    "tx_count": 0
  }
}

Response Fields

Field	Type	Description
`address`	string	The address
`chain_stats`	object	Statistics for confirmed transactions
`mempool_stats`	object	Statistics for unconfirmed transactions

GET


            /address/:address/txs

Returns a list of transactions for a Pepecoin address.

Example

curl https://peppool.space/api/address/PumNFmkevCTG6RTEc7W2piGTbQHMg2im2M/txs

Response

Content-Type: application/json

[
  {
    "txid": "dba43fd04b7ae3df8e5b596f2e7fab247c58629d622e3a5213f03a5a09684430",
    "version": 1,
    "locktime": 0,
    "vin": [ ... ],
    "vout": [ ... ],
    "size": 255,
    "weight": 1020,
    "fee": 10000,
    "status": {
      "confirmed": true,
      "block_height": 326148,
      "block_hash": "00000000000000001e4118adcfbb02364bc13c41c210d8811e4f39aeb3687e36",
      "block_time": 1413798020
    }
  },
  ...
]

GET


            /validate-address/:address

Validates a Pepecoin address and returns metadata.

Example

curl https://peppool.space/api/validate-address/PbvihBLgz6cFJnhYscevB4n3o85faXPG7D

Response

Content-Type: application/json

{
  "isvalid": true,
  "address": "PbvihBLgz6cFJnhYscevB4n3o85faXPG7D",
  "scriptPubKey": "76a914c825a1ecf2a6830c4401620c3a16f1995057c2ab88ac",
  "isscript": false
}

Response Fields

Field	Type	Description
`isvalid`	boolean	Whether the address is valid
`address`	string	The normalized address
`scriptPubKey`	string\|null	The scriptPubKey for the address, if available
`isscript`	boolean	True if the address is a script address

GET


            /tx/:txid

Returns details about a transaction.

Example

curl https://peppool.space/api/tx/2c603d097588bb7d520ffb8b270cc61865f52c1427504ab43678fc055d07c261

Response

Content-Type: application/json

{
  "txid": "2c603d097588bb7d520ffb8b270cc61865f52c1427504ab43678fc055d07c261",
  "version": 1,
  "locktime": 0,
  "vin": [...],
  "vout": [...],
  "size": 221,
  "weight": 557,
  "fee": 19,
  "status": {
    "confirmed": true,
    "block_height": 936511,
    "block_hash": "0000000000000000000222c4ff88dc74fb21daa72d326bbcabb2b97413dacb7a",
    "block_time": 1771054926
  }
}

Response Fields

Field	Type	Description
`txid`	string	Transaction ID
`version`	integer	Transaction version
`locktime`	integer	Transaction locktime
`size`	integer	Transaction size in bytes
`fee`	integer	Transaction fee in ribbits
`status`	object	Confirmation status and block info

GET


            /tx/:txid/status

Returns the confirmation status of a transaction.

Example

curl https://peppool.space/api/tx/2c603d097588bb7d520ffb8b270cc61865f52c1427504ab43678fc055d07c261/status

Response

Content-Type: application/json

{
  "confirmed": true,
  "block_height": 936511,
  "block_hash": "0000000000000000000222c4ff88dc74fb21daa72d326bbcabb2b97413dacb7a",
  "block_time": 1771054926
}

Response Fields

Field	Type	Description
`confirmed`	boolean	Whether the transaction is confirmed
`block_height`	integer	Height of the block containing the transaction (if confirmed)
`block_hash`	string	Hash of the block containing the transaction (if confirmed)
`block_time`	integer	Unix time the block was created (if confirmed)

GET


            /tx/:txid/hex

Returns the raw transaction hex.

Example

curl https://peppool.space/api/tx/2c603d097588bb7d520ffb8b270cc61865f52c1427504ab43678fc055d07c261/hex

Response

Content-Type: text/plain

010000000536a007284bd52ee826680a7f43536472f1bcce1e76cd76b826b88c5884eddf1f0c0000006b483045022100bcdf40fb3b5ebfa2c158ac8d1a41c03eb3dba4e180b00e81836bafd56d946efd022005cc40e35022b614275c1e485c409599667cbd41f6e5d78f421cb260a020a24f01210255ea3f53ce3ed1ad2c08dfc23b211b15b852afb819492a9a0f3f99e5747cb5f0ffffffffee08cb90c4e84dd7952b2cfad81ed3b088f5b...

GET


            /tx/:txid/raw

Returns the transaction as binary data.

Example

curl https://peppool.space/api/tx/2c603d097588bb7d520ffb8b270cc61865f52c1427504ab43678fc055d07c261/raw

Response

Content-Type: application/octet-stream

<binary data>

Error Responses

Errors are returned as JSON objects with an error code and a human-readable message.

{
  "code": 404,
  "error": "not_found",
  "message": "The requested resource could not be found."
}

400 Bad Request Invalid parameters or malformed request

404 Not Found Resource does not exist

429 Too Many Requests Rate limit exceeded (60 req/min)

500 Internal Error Unexpected server error