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.

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 /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
}
GET /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
}
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. 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
    }
  },
  ...
]
GET /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
  }
]
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
POST /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
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>
GET /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."
}
400 Bad Request Invalid parameters or malformed request
404 Not Found Resource does not exist
429 Too Many Requests Rate limit exceeded (15 req/min)
500 Internal Error Unexpected server error