Stats

These commands return statistical information from Piri system.

Get rich list

post

https://core.pirichain.comhttps://testnet.pirichain.comhttps://custom.networkhttp://custom.network

/getRichList

This endpoint is used on the PIRI network to access a list of wallets that hold the most of the given "assetID" asset type. Skip and limit parameters can be used for pagination.

Body

application/x-www-form-urlencoded

assetIDstringRequired

Asset ID

limitnumberRequired

Record count for per page

skipnumberOptional

Page count for skip according to limit value.

Responses

200

OK

application/json; charset=utf-8

errorinteger · int32Required

Error status code. 0 indicates success, non-zero indicates an error.

countinteger · int32Required

Total number of rich wallets found for the specified asset.

post

/getRichList

HTTPcURLJavaScriptPython

POST /getRichList HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 37

"assetID='text'&limit=1&skip=1"

200

OK

{
  "error": 0,
  "count": 5,
  "data": [
    {
      "_id": "12345678901234567890abcd",
      "address": "PRTMExampleAddress1234567890abcdefghijk",
      "assetID": -1,
      "balance": 500000
    },
    {
      "_id": "abcdef1234567890123456789",
      "address": "PRTMExampleAddress2abcdefghijk1234567890",
      "assetID": -1,
      "balance": 450000
    }
  ]
}

Get detailed statistics

post

https://core.pirichain.comhttps://testnet.pirichain.comhttps://custom.networkhttp://custom.network

/getDetailStats

This endpoint returns the total transaction count for the last 10 processed days on the PIRI network in the form of a statistical series.

Body

application/x-www-form-urlencoded

assetIDstringOptional

Asset ID

Responses

200

OK

application/json; charset=utf-8

Array of daily transaction statistics for the last 10 processed days

_idstringRequired

The date identifier in YYYY-MM-DD format representing the day for which statistics are reported.

countinteger · int32Required

The total number of transactions processed on this specific date.

post

/getDetailStats

HTTPcURLJavaScriptPython

POST /getDetailStats HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 18

"assetID='text'"

200

OK

[
  {
    "_id": "2022-04-27",
    "count": 1
  },
  {
    "_id": "2022-04-28",
    "count": 9
  },
  {
    "_id": "2022-04-29",
    "count": 13
  },
  {
    "_id": "2022-04-30",
    "count": 10
  },
  {
    "_id": "2022-05-01",
    "count": 23
  },
  {
    "_id": "2022-05-02",
    "count": 15
  },
  {
    "_id": "2022-05-03",
    "count": 1
  },
  {
    "_id": "2022-05-04",
    "count": 24
  },
  {
    "_id": "2022-05-05",
    "count": 23
  },
  {
    "_id": "2022-05-06",
    "count": 5
  }
]

Get statistics

post

https://core.pirichain.comhttps://testnet.pirichain.comhttps://custom.networkhttp://custom.network

/getStats

This endpoint is used to display summary information related to the PIRI network.

Responses

200

OK

application/json; charset=utf-8

blockCountinteger · int32Required

Total number of blocks processed in the PIRI network.

transactionCountinteger · int32Required

Total number of transactions completed in the network.

poolTransactionCountinteger · int32Required

Number of transactions currently waiting in the transaction pool.

tokenCountinteger · int32Required

Total number of tokens created on the PIRI network.

addressCountinteger · int32Required

Total number of unique addresses that have been active on the network.

customDataSizestringRequired

Total size of custom data stored on the blockchain, displayed in human-readable format.

deputyCountinteger · int32Required

Current number of deputy nodes participating in the network consensus.

post

/getStats

HTTPcURLJavaScriptPython

POST /getStats HTTP/1.1
Host: core.pirichain.com
Accept: */*

200

OK

{
  "blockCount": 250000,
  "transactionCount": 350000,
  "poolTransactionCount": 5,
  "tokenCount": 8,
  "addressCount": 340000,
  "customDataSize": "40.00 KB",
  "totalBurnedPiri": [
    {
      "_id": null,
      "total": 35000
    }
  ],
  "deputyCount": 6,
  "totalFrozenData": [
    {
      "_id": null,
      "totalFrozen": 280000
    }
  ]
}

Get circulation

post

https://core.pirichain.comhttps://testnet.pirichain.comhttps://custom.networkhttp://custom.network

/getCirculation

This endpoint provides the total amount of PIRI circulating in the PIRI network.

Responses

200

OK

application/json; charset=utf-8

errorinteger · int32Required

Error status code. 0 indicates success, non-zero indicates an error.

amountinteger · int32Required

The total amount of PIRI tokens currently circulating in the network.

post

/getCirculation

HTTPcURLJavaScriptPython

POST /getCirculation HTTP/1.1
Host: core.pirichain.com
Accept: */*

200

OK

{
  "error": 0,
  "amount": 2005000
}

Deprecated

Get total burned PIRI

post

https://core.pirichain.comhttps://testnet.pirichain.comhttps://custom.networkhttp://custom.network

/getTotalBurnedPiri

This endpoint is used to list the amount of PIRI burned in the PIRI network in the last 10 days.

Responses

200

OK

application/json; charset=utf-8

_idstringRequired

The date identifier in YYYY-MM-DD format representing the day for which burned PIRI statistics are reported.

countnumberRequired

The total amount of PIRI tokens burned on this specific date.

post

/getTotalBurnedPiri

HTTPcURLJavaScriptPython

POST /getTotalBurnedPiri HTTP/1.1
Host: core.pirichain.com
Accept: */*

200

OK

[
  {
    "_id": "2024-08-15",
    "count": 0.5
  },
  {
    "_id": "2024-08-16",
    "count": 1.2
  },
  {
    "_id": "2024-08-17",
    "count": 0.8
  },
  {
    "_id": "2024-08-18",
    "count": 1
  },
  {
    "_id": "2024-08-19",
    "count": 0.3
  }
]