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 15 requests per minute per IP address.
/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
/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
/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 |
/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 |
/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..."
]
/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 |
/mempool/fee-estimates
Returns a map of block targets to estimated fee rates in ribbits per virtual byte (RIBBITS/vB).
Example
curl https://peppool.space/api/mempool/fee-estimates
Response
Content-Type: application/json
{
"2": 10.03,
"3": 8.5,
"6": 5.2,
"144": 1.0
}
/fees/recommended
Returns recommended fee rates as integers for different confirmation targets.
Example
curl https://peppool.space/api/fees/recommended
Response
Content-Type: application/json
{
"fastestFee": 10,
"halfHourFee": 8,
"hourFee": 5,
"economyFee": 2,
"minimumFee": 1
}
/fees/precise
Returns precise floating-point fee estimates for different confirmation targets.
Example
curl https://peppool.space/api/fees/precise
Response
Content-Type: application/json
{
"fastestFee": 10.028,
"halfHourFee": 8.5,
"hourFee": 5.23,
"economyFee": 2.0,
"minimumFee": 1.0
}
/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 |
/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 |
/address/:address/txs
Returns a list of transactions for a Pepecoin address. Returns up to 50 mempool transactions plus the first 25 confirmed transactions. More confirmed transactions can be requested using the after_txid query parameter.
Example
curl https://peppool.space/api/address/PumNFmkevCTG6RTEc7W2piGTbQHMg2im2M/txs
curl https://peppool.space/api/address/PumNFmkevCTG6RTEc7W2piGTbQHMg2im2M/txs?after_txid=dba43fd04b7ae3df8e5b596f2e7fab247c58629d622e3a5213f03a5a09684430
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
}
},
...
]
/address/:address/utxo
Returns the unspent transaction outputs (UTXOs) for a Pepecoin address.
Example
curl https://peppool.space/api/address/PumNFmkevCTG6RTEc7W2piGTbQHMg2im2M/utxo
Response
Content-Type: application/json
[
{
"txid": "58ed78527f8c2fc7e745d18c72978e6aaeb450b4816472a841d2d6453b6accb1",
"vout": 0,
"status": {
"confirmed": true,
"block_height": 916697,
"block_hash": "a991281771fb38bc5a0ac0b8a3872451c243fddd49116a3805a78a58c24620aa",
"block_time": 1771080551
},
"value": 100000000
},
{
"txid": "9fcd620fff32eff8d9d48de65100501098d48eb175ad993d44c434ff7e462756",
"vout": 1,
"status": {
"confirmed": true,
"block_height": 916835,
"block_hash": "a1b0da083051e4a2c06eb2f5fdffd950b8ca0cb14672b72d908e928340cd1737",
"block_time": 1771089008
},
"value": 100000000
}
]
/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 |
/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 |
/tx
Broadcasts a raw transaction to the network. The transaction hex should be provided in the request body.
Example
curl -X POST --data "01000000..." https://peppool.space/api/tx
Response
Content-Type: text/plain
2c603d097588bb7d520ffb8b270cc61865f52c1427504ab43678fc055d07c261
/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) |
/tx/:txid/hex
Returns the raw transaction hex.
Example
curl https://peppool.space/api/tx/2c603d097588bb7d520ffb8b270cc61865f52c1427504ab43678fc055d07c261/hex
Response
Content-Type: text/plain
010000000536a007284bd52ee826680a7f43536472f1bcce1e76cd76b826b88c5884eddf1f0c0000006b483045022100bcdf40fb3b5ebfa2c158ac8d1a41c03eb3dba4e180b00e81836bafd56d946efd022005cc40e35022b614275c1e485c409599667cbd41f6e5d78f421cb260a020a24f01210255ea3f53ce3ed1ad2c08dfc23b211b15b852afb819492a9a0f3f99e5747cb5f0ffffffffee08cb90c4e84dd7952b2cfad81ed3b088f5b...
/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>
/inscription/:inscription_id
Returns details about a Pepecoin inscription (Pepeinal). The inscription ID format is <txid>i<index>.
Example
curl https://peppool.space/api/inscriptionabc...defi0
Response
Content-Type: application/json
{
"id": "5f48e29e...e2f3i0",
"number": 17212333,
"address": "Pvkk9bUW8S4AK4cJeDDebnWJNADNCtxCHG",
"child_count": 0,
"children": [],
"content_type": "image/png",
"effective_content_type": "image/png",
"content_length": 793,
"delegate": null,
"fee": 10210000,
"height": 956437,
"value": 100000,
"parent_count": 0,
"parents": [],
"properties": {
"title": "peppool",
"traits": {
"eyes": "laser"
}
},
"satpoint": "5f48e29e...e2f3:0:0",
"timestamp": 1773570237,
"next": "1a560cb5...2bc5i0",
"previous": "8cc1647b...9df9i0"
}
Response Fields
| Field | Type | Description |
|---|---|---|
id
|
string | Unique inscription identifier (<txid>i<index>) |
number
|
integer | Sequential inscription number |
address
|
string|null | Current owner address |
child_count
|
integer | Number of child inscriptions |
children
|
array | Array of child inscription IDs |
content_type
|
string|null | MIME type of the inscription content |
effective_content_type
|
string | Final resolved MIME type of the inscription (considering delegates) |
content_length
|
integer|null | Content size in bytes |
delegate
|
string|null | ID of the inscription whose content is used |
fee
|
integer | Fee paid for the inscription transaction in ribbits |
height
|
integer | Block height where the inscription was created |
value
|
integer | Output value in ribbits |
parent_count
|
integer | Number of parent inscriptions |
parents
|
array | Array of parent inscription IDs |
properties
|
object|null | Properties (e.g. title, traits) |
satpoint
|
string | Satpoint location (txid:vout:offset) |
timestamp
|
integer | Unix timestamp of the inscription block |
next
|
string|null | Next inscription ID |
previous
|
string|null | Previous inscription ID |
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."
}