The MochiMap API is a selfless service (pats self on back) provided to the Mochimo community, for access to Mochimo Block data, Transaction data, Chain statistics and Network Node details via secure and reliable HTTPS requests and JSON responses.
The MochiMap API interprets blockchain and transaction data from the Mochimo Cryptocurrency Network and stores it as Developer friendly JSON data. This data is publicly accessible via the MochiMap API endpoints, listed below, allowing for both simple and complex queries and search patterns for querying exactly the data you might need.
The MochiMap API status page is powered by the UptimeRobot and contains global and regional uptime history of the MochiMap API across all of it's publicly accessible servers.
The MochiMap API can be accessed using a few different domains. Though it's highly recommended that you use the recommended domain for almost all cases, alternative domains are spread across the globe for redundancy and backup requirements.
Requests made to api.mochimap.com will redirected to the closest available regional domain, based on latency calculation, and is therefore the recommended domain for access to the MochiMap API.
Alternatively, you can opt to use one of the various regional domains, via their associated region prefix. Regional domains are spread across the globe for redundancy and backup requirements, but requests made directly to these domains WILL NOT be redirected to a working server in the case of downtime due to maintenance or a failure. Regional domains currently reside in Germany, Singapore and United States under their respective domains listed below...
- de.mochimap.com ~
- sg.mochimap.com ~
- us.mochimap.com ~
- GET [base]/block/<blockNumber>, where
- <blockNumber> is left blank to obtain latest block data; or
- <blockNumber> is a positive integer in base-10 or hex format
- e.g. get latest block data:
- e.g. get block data for block number 287117:
- TYPICAL RESULT
{
"_id": "000000000004618d-a2478305a3300850",
"type": "normal",
"size": 231804,
"bnum": 287117,
"time0": 1624655470,
"stime": 1624655600,
"difficulty": 34,
"bhash": "a2478305a3300850...fb437c6e2583d69f",
"phash": "7a819323892d94ba...0c48435f92f62546",
"mroot": "5a5c07637d44b2a1...86aea762b7c21bd3",
"nonce": "0eff0147a2013200...4b00000000000000",
"maddr": "729fe006c47c498d...85a36ab38d5552f0",
"mreward": 46407192000,
"mfee": 500,
"amount": 117279360901,
"tcount": 26
}- GET [base]/block/search[?<parameter>[:<modifier>]=<value>]
- where <parameter> is a property of the desired block data; and
- where <modifier> is used to modify how a properties value is interpreted; and
- where <value> is the associated property value used for the search
- e.g. search blocks containing more than 10 transactions, solved by addresses beginning with abc...
- e.g. search pseudoblocks:
- TYPICAL RESULT
{
"duration": 393,
"found": 2861,
"pages": 358,
"results": [
{
"_id": "0000000000046204-454a3938da3d09aa",
"type": "pseudo",
"size": 164,
"bnum": 287236,
"time0": 1624693012,
"stime": 1624693961,
"difficulty": 36,
"bhash": "454a3938da3d09aa...303d8c7fecb7abc2",
"phash": "7ec34c376c5cbd72...b6aa90d70a1973515"
},
{ "...": "7 more results" }
]
}- GET [base]/chain/<blockNumber>, where
- <blockNumber> is left blank to obtain latest chain data; or
- <blockNumber> is a positive integer in base-10 or hex format
- e.g. get latest chain data:
- e.g. get chain data for block number 287117:
- TYPICAL RESULT
{
"phash": "7a819323892d94ba...0c48435f92f62546",
"bnum": 287117,
"mfee": 500,
"tcount": 26,
"time0": 1624655470,
"difficulty": 34,
"mroot": "5a5c07637d44b2a1...86aea762b7c21bd3",
"nonce": "0eff0147a2013200...4b00000000000000",
"stime": 1624655600,
"bhash": "a2478305a3300850...fb437c6e2583d69f",
"txfees": 13000,
"reward": 46407192000,
"mreward": 46407205000,
"blocktime": 130,
"blocktime_avg": 313.81,
"hashrate": 132152839,
"hashrate_avg": 160158087,
"aeonRewards": 6124358488000,
"aeonPseudoblocks": 9,
"maxSupply": 76031020786194600,
"supply": 11423211134242192
}- GET [base]/ledger/<addressType>/<address>, where
- <addressType> is either "address" or "tag"; and
- <address> is a hashed or tagged address; respectively
- e.g. get ledger entry for address beginning with 287a8fb2:
- e.g. get ledger entry for tagged address beginning with c0ffee:
- TYPICAL RESULT
{
"address": "26f879942289bf1a...c0ffeec0ffeec0ffeec0ffee",
"addressHash": "8906b6df9148c437...20754fec72d55e09",
"tag": "c0ffeec0ffeec0ffeec0ffee",
"balance": 75456516340552
}- GET [base]/ledger/search[?<parameter>[:<modifier>]=<value>]
- where <parameter> is a property of the desired ledger balance data; and
- where <modifier> is used to modify how a properties value is interpreted; and
- where <value> is the associated property value used for the search
- e.g. search ledger balances of tag beginning with c0ffee...
- TYPICAL RESULT
{
"duration": 453,
"found": 3,
"pages": 1,
"results": [
{
"_id": "0000000000046100-d87f31a16c521323-c0ffeec0ffeec0ffeec0ffee",
"bhash": "d87f31a16c521323...4314f96bcb769ac5",
"timestamp": 1624612231,
"bnum": 286976,
"address": "26f879942289bf1a...18698a0688380f6d",
"addressHash": "8906b6df9148c437...20754fec72d55e09",
"tag": "c0ffeec0ffeec0ffeec0ffee",
"balance": 75456516340552,
"delta": -2745000000500
},
{ "...": "2 more results" }
]
}- GET [base]/network/<active>/<IPv4>, where
- <active> is optionally added to obtain node details; ONLY if
- the node is actively accessible as a Mochimo Network node
- <IPv4> is an IPv4 address
- <active> is optionally added to obtain node details; ONLY if
- e.g. get network node details from 95.179.216.152 ONLY if active:
- e.g. get network node details from 95.179.216.152:
- TYPICAL RESULTS
{
"_id": "95-179-216-152",
"host": {
"ip": "95.179.216.152",
"port": 2095
},
"connection": {
"de": {
"status": 0,
"ping": 1060,
"baud": 132149,
"timestamp": 1624711676837,
"uptimestamp": 1624669216091
},
"sg": { "...": "like connection.de" },
"us": { "...": "like connection.de" }
},
"pversion": 4,
"cbits": 17,
"network": 1337,
"cblock": 287290,
"cblockhash": "32a47b74f37af534...b7892b5b07a411e0",
"pblockhash": "6154c72ca51ef252...dfcf6ef17c048ab7",
"weight": "383a1381c9b55f696",
"peers": [
"207.180.222.97",
"5.188.4.25",
"35.208.22.197",
"68.148.89.244",
{ "...": "28 more peers" }
]
}- GET [base]/network/search[?<parameter>[:<modifier>]=<value>]
- where <parameter> is a property of the desired ledger balance data; and
- where <modifier> is used to modify how a properties value is interpreted; and
- where <value> is the associated property value used for the search
- e.g. find network nodes that are no longer connected to the network:
- TYPICAL RESULTS
{
"duration": 370,
"found": 1,
"results": [
{
"_id": "35-208-54-226",
"host": {
"ip": "35.208.54.226",
"port": 2095
},
"connection": {
"de": {
"status": -1,
"ping": null,
"baud": null,
"timestamp": 1623901791833,
"uptimestamp": -1
},
"sg": { "...": "like connection.de" },
"us": { "...": "like connection.de" }
},
"pversion": 4,
"cbits": 17,
"network": 1337,
"cblock": 284651,
"cblockhash": "89f3a64810f3995a...e7706ffc03e4ee4e",
"pblockhash": "038dd5a9808597b1...5bf2d12c78cbd178",
"weight": "383a0d15c9b55f696",
"peers": [
"217.76.158.158",
"5.183.8.183",
"144.91.67.74",
"139.162.252.168",
{ "...": "28 more peers" }
]
}
]
}- GET [base]/transaction/<txid>, where
- <txid> is the txid hash of a transaction
- e.g. get transaction data for txid ff3d5ba80aff9986...:
- TYPICAL RESULT
{
"_id": "000000000004623e-93fade70ed2dd22c-ff3d5ba80aff9986...3f1e2351967251bb",
"stime": 1624712529,
"bnum": 287294,
"bhash": "93fade70ed2dd22c...75d87045c191fd37",
"txid": "ff3d5ba80aff9986...3f1e2351967251bb",
"txsig": "01a66e54547cc557...fc522479381e6d3c",
"srcaddr": "178c5780218b86f6...61469776a1f2e4e5",
"srctag": "420000000e00000001000000",
"dstaddr": "c1fb2c9c92ca9d98...8d6610adc3b0c48e",
"dsttag": "420000000e00000001000000",
"chgaddr": "83c3f1bb4edfda34...77fb96668959c154",
"chgtag": "420000000e00000001000000",
"sendtotal": 23707567877,
"changetotal": 5368437937,
"txfee": 500
}- GET [base]/transaction/search[?<parameter>[:<modifier>]=<value>][&]
- where <parameter> is a direct property of the transaction data; and
- where <modifier> is used to modify how a property is interpreted; and
- where <value> is the associated propety value used for the search
- e.g. find the latest transactions:
- e.g. find transactions where send total is greater than 1,000 MCM:
- TYPICAL RESULT
{
"duration": 1043,
"found": 864,
"pages": 108,
"results": [
{
"_id": "0000000000045d3b-977c8ea2c489e591-1af7375c2707877d...40c4570ac2c056d9",
"stime": 1624315034,
"bnum": 286011,
"bhash": "977c8ea2c489e591...63401099de418e54",
"txid": "1af7375c2707877d...40c4570ac2c056d9",
"txsig": "8cba76056f0fa0a5...086960d365758ff4",
"srcaddr": "50693b379aac7535...481396d7bb7a322a",
"srctag": "b0909e9738afec33d4a24a90",
"dstaddr": "6127d05ef95819b3...3c80e28d112d4c2e",
"dsttag": "c94dd1793727bb32d7521329",
"chgaddr": "cea985ebcf365956...7df997654163ac64",
"chgtag": "b0909e9738afec33d4a24a90",
"sendtotal": 15899999999500,
"changetotal": 501,
"txfee": 500
},
{ "...": "7 more results" }
]
}With the exception of Special Transaction Search Parameters (see below) and the "exists" Modifier (see further below), search parameters can be any field name contained within the expected JSON results. If the desired search parameter is not a top-level parameter, all parent fields names must be including and suffixed with a dot "." character (e.g. ?connection.de.status=0).
Exclusively active when performing a Transaction Search, there are a couple of parameters which are interpreted indirectly. Valid special parameters are as follows:
- ?address[:<modifier>]=<value>; matches results where
- srcaddr[:<modifier>]=<value>; or
- dstaddr[:<modifier>]=<value>; or
- chgaddr[:<modifier>]=<value>
- i.e. provides transaction history for an address
- ?tag[:<modifier>]=<value>; matches results where
- srctag[:<modifier>]=<value>; or
- dsttag[:<modifier>]=<value>; or
- chgtag[:<modifier>]=<value>
- i.e. provides transaction history for a tagged address
Modifiers can optionally be appended to search parameters to modify how a search query interprets matching results. Usage of modifiers outside of this specification will be ignored. Valid modifiers are as follows:
- ?<parameter>[:begins]=<value>; matches results where
- the <parameter> value "begins with" <value>
- ?<parameter>[:contains]=<value>; matches results where
- the <parameter> value "contains" <value>
- ?<parameter>[:ends]=<value>; matches results where
- the <parameter> value "ends with" <value>
- ?<parameter>[:exists]=<value>; matches results where
- the <parameter>'s "existance" matches the specified Boolean <value>
- i.e. where <value> = 'false' or is otherwise "falsy", results must not contain a <parameter> field
- the <parameter>'s "existance" matches the specified Boolean <value>
- ?<parameter>[:gt]=<value>; matches results where
- the <parameter> value "is greater than" <value>
- ?<parameter>[:gte]=<value>; matches results where
- the <parameter> value "is greater than or equal to" <value>
- ?<parameter>[:lt]=<value>; matches results where
- the <parameter> value "is less than" <value>
- ?<parameter>[:lte]=<value>; matches results where
- the <parameter> value "is less than or equal to" <value>
- ?<parameter>[:ne]=<value>; matches results where
- the <parameter> value "is not equal to" <value>
Note: the 'gt', 'gte', 'lt', 'lte' and 'ne' modifiers can produce unintended results when used with non-number type values
More often than not, you can find me online in the Mochimo Official Discord Server.
Otherwise, checkout my Github profile for other forms of contact.
This project is licensed under the GNU Affero General Public License version 3.
... see the LICENSE file for details.