REST API

API for Warthog node version v0.10.3 "dd054a2"

Configuration

API is accessed via the RPC endpoints of the node. The endpoints socket can be configured via the --rpc command line option:

JSON RPC endpoint options:
  -r, --rpc=IP:PORT          JSON RPC endpoint  (default=`127.0.0.1:3000')

For example invoke

$./wart-node --rpc=0.0.0.0:3000

to start the node with RPC listening on all devices on port 3000.

Below we assume the RPC socket is accessible at localhost:3000. On startup the node reports the RPC endpoint setting:

[info] RPC endpoint is 127.0.0.1:3000.

Overview

Method Path Description
POST /transaction/add Send transactions
GET /transaction/mempool Show content of mempool
GET /transaction/lookup/:txid Transaction lookup by transaction ID
GET /transaction/latest Show latest transactions
GET /transaction/minfee Show the minimum fee required by this node
GET /settings/mempool/minfee/:feeE8 Adjust the minimum transaction fee
GET /chain/head Show info on chain head
GET /chain/grid Show header grid (used for sync)
GET /chain/block/:id/hash Show hash of specific block
GET /chain/block/:id/header Show header of specific block
GET /chain/block/:id/binary Show binary data of specific block
GET /chain/block/:id Show header and body of specific block
GET /chain/mine/:account Generate data required for mining
GET /chain/txcache Show transaction cache
GET /chain/hashrate/:window Show current hashrate based on latest N blocks
GET /chain/signed_snapshot Show chain snapshot
GET /chain/hashrate/chart/block/:from/:to/:window Show hashrate chart by block range
GET /chain/hashrate/chart/time/:from/:to/:interval Show hashrate chart by time range
GET /chart/candles/:asset/:interval?from=...&to=...&n=... Show OHLCV candle data for a timeframe (5m, 1h, 1d)
GET /chart/trades/:asset?from=...&to=...&n=... Show trade data
POST /chain/append Append mined block
GET /token/complete Search tokens by name and/or hash prefix
GET /market/:market Show market orders and liquidity pool
GET /account/:account/mempool Show mempool transactions for account
GET /account/:account/open_orders Show all open orders for account
GET /account/:account/open_orders/:asset Show open orders for account and specific asset
GET /account/:account/balance/:token Show balance of specific account for a token
GET /account/:account/balance_wart Show WART balance of specific account
GET /account/:account/history/:beforeTxIndex Show transaction history of specific account
GET /account/richlist/:token Show richlist for a specific token
GET /peers/ip_count Show peer IP counts
GET /peers/banned Show banned peers
GET /peers/offenses/:page Show offenses of peers
GET /peers/connected/connection Show connection info of connected peers
GET /peers/connection_schedule Show connection schedule
GET /peers/unban Unban all peers
GET /peers/connected Show info of connected peers
GET /peers/disconnect/:id Disconnect a specific peer
GET /peers/throttled Show throttled peers
GET /peers/transmission_hours Show transmission data by hours
GET /peers/transmission_minutes Show transmission data by minutes
GET /tools/encode16bit/from_e8/:feeE8 Round raw 64 integer to closest 16 bit representation
GET /tools/encode16bit/from_string/:string Round coin amount string to closest 16 bit representation
GET /tools/parse_price/:price/:precision Parse price adjusted for asset precision
GET /tools/info Print information about this node
GET /tools/wallet/new Create a new wallet
GET /tools/wallet/from_privkey/:privkey Restore wallet from a private key
GET /tools/janushash_number/:headerhex Show number interpretation of a header's Janushash
GET /tools/sample_verified_peers/:number List verified peers
GET /debug/header_download Show header download status
GET /loadtest/block_request/:conn_id Load test block request
GET /loadtest/header_request/:conn_id Load test header request
GET /loadtest/disable/:conn_id Disable load test connection
GET /debug/fakemine Generate fake mining data (default address)
GET /debug/rollback Rollback chain
GET /debug/fakemine/:address Generate fake mining data for address

For WebSocket API documentation, see WebSocket API.

Detailed Description

POST /transaction/add

Create new transactions as described here. Returns transaction hash in hex format:

GET /transaction/mempool

Show content of mempool. Example output:

{
"code": 0,
"data": {
 "data": []
}
}

GET /transaction/lookup/:txid

Transaction lookup by transaction id. Example output of /transaction/lookup/4b3bc48295742b71ff7c3b98ede5b652fafd16c67f0d2db6226e936a1cdbf0a5:

{
"code": 0,
"data": {
 "transaction": {
  "amount": "3.00000000",
  "amountE8": 300000000,
  "blockHeight": 376696,
  "confirmations": 8,
  "timestamp": 1695472249,
  "toAddress": "848b08b803e95640f8cb30af1b3166701b152b98c2cd70ee",
  "txHash": "4b3bc48295742b71ff7c3b98ede5b652fafd16c67f0d2db6226e936a1cdbf0a5",
  "type": "Reward",
  "utc": "2023-09-23 12:30:49 UTC"
 }
}
}

GET /transaction/latest

Show latest transactions. Returns the most recent blocks with their full transaction details.

Output:

  • count — total number of transactions returned
  • fromId — the lowest history ID in the result set
  • perBlock — array of blocks, each containing header, body, confirmations, height, timestamp, utc

Example output of /transaction/latest:

{
 "code": 0,
 "data": {
  "count": 49,
  "fromId": 1,
  "perBlock": [
   {
    "body": {
     "assetCreations": [...],
     "cancelations": [...],
     "liquidityDeposits": [...],
     "liquidityWithdrawals": [...],
     "matches": [...],
     "newOrders": [...],
     "orderCancelations": [...],
     "rewards": [...],
     "tokenTransfers": [...],
     "wartTransfers": [...]
    },
    "confirmations": 1,
    "header": {
     "difficulty": 536871040.0000305,
     "hash": "7deb38e45a74b96d02166dfd8f6627bbbefd8dc25a20727885bb21eeb52a3cb4",
     "merkleroot": "...",
     "nonce": "00000000",
     "pow": { ... },
     "prevHash": "...",
     "raw": "...",
     "target": "077fffff",
     "timestamp": 1772443430,
     "utc": "2026-03-02 09:23:50 UTC",
     "version": "00000004"
    },
    "height": 23,
    "timestamp": 1772443430,
    "utc": "2026-03-02 09:23:50 UTC"
   },
   ...
  ]
 }
}

Transaction Details
transaction-details/

GET /transaction/minfee

Show the minimum fee required by this node. Transactions with a lower fee will not be accepted or requested by the node.

Exemple output :

{
 "code": 0,
 "data": {
  "16bit": 13537,
  "E8": 9992,
  "amount": "0.00009992"
 }
}

GET /settings/mempool/minfee/:feeE8

Adjust the minimum transaction fee. The desired new minimum transaction fee should be specified.

Exemple output:

{
 "code": 0,
 "data": {
  "deleted": 0
 }
}

You can also set the min fee when launching your node.

Exemple:

$./wart-node --minfee="0.00009992"

GET /chain/head

Show info on chain head. Example output:

{
"code": 0,
"data": {
 "difficulty": 30866431555762.105,
 "hash": "e9dfdcfdeec3c5376dd682e09cce909dc255d611e9cb36974bcbcbcecb6fb432",
 "height": 1198931,
 "is_janushash": true,
 "pinHash": "a7bd097d9c10dc393239f169f6dd5352e0b4e28e942aaa78b54c57ed1ec7315b",
 "pinHeight": 1198912,
 "synced": true,
 "worksum": 1.008584641271857e+19,
 "worksumHex": "0x0000000000000000000000000000000000000000000000008bf81fe0113cf6a0"
}
}

GET /chain/grid

Show hexadecimal header grid. This grid is used for chain sync to allow nodes spot points where chains diverge. Example output (truncated):

{
"code": 0,
"data": [
 "19f65d40c6bc02a16378712bd7652eaebc925955e96c0262641314520000000021c88fbd99f0d3369f7f1ad981e11b8c6f032e13d4ef28311226ea5c8574c3fe3635b32500000001649f78127c04d23d",
 "0e43cf390ca986fabbed37a33386b4ad73723d51fab291d12013351f0000000021d1c6076e52222fb8c83fe33d55c610482cd272b7789646710510df3ba37a4f55b30e4e0000000164a221eb03577627",
 .
 .
 .
]
}

GET /chain/block/:id/hash

Show hash of specific block. Example output of /chain/block/366700/hash

{
"code": 0,
"data": {
 "hash": "ac4f50ef90c0730075f4995d0b33691e9e7d69f84d2191c029371c0000000000"
}
}

GET /chain/block/:id/header

Show header of specific block.

Example output of /chain/block/366700/header

{
"code": 0,
"data": {
 "header": {
  "difficulty": 5850035871080.048,
  "hash": "ac4f50ef90c0730075f4995d0b33691e9e7d69f84d2191c029371c0000000000",
  "merkleroot": "a4d44aff9ebd539f2b5e758fb76df22bfd13a2e4d894752c7892f9e9c3f3d969",
  "nonce": "0d8e8eab",
  "prevHash": "11f2b6860910f7b544e01fd5ed5419588c29e42b305553bd492a0d0000000000",
  "raw": "11f2b6860910f7b544e01fd5ed5419588c29e42b305553bd492a0d00000000002ac075d9a4d44aff9ebd539f2b5e758fb76df22bfd13a2e4d894752c7892f9e9c3f3d96900000001650bd0820d8e8eab",
  "target": "d975c02a",
  "timestamp": 1695273090,
  "utc": "2023-09-21 05:11:30 UTC",
  "version": "00000001"
 }
}
}

GET /chain/block/:id/binary

Show binary data of specific block with structure annotations.

TODO: Add JSON output example

GET /chain/block/:id

Show header and body of specific block. Example output of /chain/block/366700

{
"code": 0,
"data": {
 "body": {
  "rewards": [
   {
    "amount": "3.00000001",
    "amountE8": 300000001,
    "toAddress": "848b08b803e95640f8cb30af1b3166701b152b98c2cd70ee",
    "txHash": "660b6f0883e4b295d5a3920eea9c73636787b932efd00cacc6d3a9a89f540714"
   }
  ],
  "transfers": [
   {
    "amount": "5000.00000000",
    "amountE8": 500000000000,
    "fee": "0.00000001",
    "feeE8": 1,
    "fromAddress": "1711cadfe5a66a5f5f245fc78b2335f79da362178a72de2e",
    "nonceId": 131630562,
    "pinHeight": 366688,
    "toAddress": "8733d0e21bc791f44785f02753bb589b8423eb56cd938fbc",
    "txHash": "f364da997bf7a3c3bc8ead22041509228d6bdea39fcbcdc6be56030433d54219"
   }
  ]
 },
 "confirmations": 9970,
 "header": {
  "difficulty": 5850035871080.048,
  "hash": "ac4f50ef90c0730075f4995d0b33691e9e7d69f84d2191c029371c0000000000",
  "merkleroot": "a4d44aff9ebd539f2b5e758fb76df22bfd13a2e4d894752c7892f9e9c3f3d969",
  "nonce": "0d8e8eab",
  "prevHash": "11f2b6860910f7b544e01fd5ed5419588c29e42b305553bd492a0d0000000000",
  "raw": "11f2b6860910f7b544e01fd5ed5419588c29e42b305553bd492a0d00000000002ac075d9a4d44aff9ebd539f2b5e758fb76df22bfd13a2e4d894752c7892f9e9c3f3d96900000001650bd0820d8e8eab",
  "target": "d975c02a",
  "timestamp": 1695273090,
  "utc": "2023-09-21 05:11:30 UTC",
  "version": "00000001"
 },
 "height": 366700,
 "timestamp": 1695273090,
 "utc": "2023-09-21 05:11:30 UTC"
}
}

GET /chain/mine/:account

Generate data required for mining. Example output of /chain/mine/11c6c0f7148a845cc899360a38fa839ba3d5e719293bb5c6

{
 "code": 0,
 "data": {
  "blockReward": "3.00000000",
  "blockRewardE8": 300000000,
  "body": "000000000000000000000001e94f274f08cf64bd76688ffb34012269e045b737000000000000098d0000000011e1a300",
  "difficulty": 30866431555762.105,
  "header": "50eaaf1453c84cabef749af9064d73d881174a44d7f165122400604e71342f9d0b2479fd6ec2b44e00bed326c9116b2f85f9f72bdd2157cc521cf49d0cf360fad91b881e00000002660ab00400000000",
  "height": 1198924,
  "merklePrefix": "72aa3aa84afd92af788b750d28ed9fe247d8788956bbdddc5a92cbdcb5925e4fbe20dcff8dc31364a524061ff0235bd78c9786d6d29dd2a73b49efacb57966d6",
  "synced": true,
  "testnet": false,
  "totalTxFee": "0",
  "totalTxFeeE8": 0
 }
}```

### `GET /chain/txcache`

 Show transaction cache. Example output:

 ```json
{
 "code": 0,
 "data": []
 }

GET /chain/hashrate/:window

Show current hashrate based on latest n blocks

Example output of /chain/hashrate/100

{
"code": 0,
"data": {
 "lastNBlocksEstimate": 296429051797,
 "N": 100
}
}

GET /chain/signed_snapshot

Show chain snapshot. Example output

{
"code": 0,
"data": {
 "priority": {
   "height": 1198912,
   "importance": 12345
 },
 "hash": "a7bd097d9c10dc393239f169f6dd5352e0b4e28e942aaa78b54c57ed1ec7315b",
 "signature": "..."}
}
}

GET /chain/hashrate/chart/block/:from/:to/:window

Show hashrate chart data for a block range.

TODO: Add JSON output example

GET /chain/hashrate/chart/time/:from/:to/:interval

Show hashrate chart data for a time range.

TODO: Add JSON output example

POST /chain/append

Append mined block. Miners must POST mined block they received from GET /chain/mine/:address. TODO: Detailed description

GET /token/complete

Search tokens by name prefix and/or hash prefix. Query parameters: namePrefix and hashPrefix.

TODO: Add JSON output example

GET /market/:market

Show market orders and liquidity pool for a specific asset. The :market parameter is the asset identifier.

TODO: Add JSON output example

GET /account/:account/mempool

Show mempool transactions for a specific account.

TODO: Add JSON output example

GET /account/:account/open_orders

Show all open orders for a specific account.

TODO: Add JSON output example

GET /account/:account/open_orders/:asset

Show open orders for a specific account and asset.

TODO: Add JSON output example

GET /account/:account/balance/:token

Show balance of an account for a specific asset. The :account parameter is the account address, and :token is the token spec (e.g., asset:0e4825efffa294610d2ac376713e3bcc9b53d378e823834b64e5df01f75d3b0c).

Balance Types

The API returns three balance types:

Type Description
total The total balance of the account
locked Balance locked in open orders
mempool Balance currently used by pending transactions in the mempool

Spendable amount is total - locked and can be reused for new transactions. If total - locked is sufficient but total - locked - mempool is not, the system may evict lower-fee transactions from the mempool to make room for a higher-fee transaction.

Example output:

{
 "code": 0,
 "data": {
  "account": {
   "accountId": 9,
   "address": "2de77d5e23dc63e4c4149d394c979361e9e8e966336c8cd4"
  },
  "balance": {
   "locked": {
    "precision": 4,
    "str": "12479.9990",
    "u64": 124799990
   },
   "mempool": {
    "precision": 4,
    "str": "100.0000",
    "u64": 1000000
   },
   "total": {
    "precision": 4,
    "str": "30899.9999",
    "u64": 308999999
   }
  },
  "lookupTrace": {
   "fails": [],
   "snapshotHeight": null
  },
  "token": {
   "id": 15,
   "name": "TOK2",
   "precision": 4,
   "spec": "asset:0e4825efffa294610d2ac376713e3bcc9b53d378e823834b64e5df01f75d3b0c"
  }
 }
}

GET /account/:account/balance_wart

Show WART balance of a specific account.

TODO: Add JSON output example

GET /account/:account/history/:beforeTxIndex

Show transaction history of specific account Example output:

{
"code": 0,
"data": {
 "balance": "5027.00000000",
 "balanceE8": 502700000000,
 "fromId": 69626,
 "perBlock": [
  {
   "confirmations": 9949,
   "height": 366700,
   "transactions": {
    "rewards": [],
    "transfers": [
     {
      "amount": "5000.00000000",
      "amountE8": 500000000000,
      "fee": "0.00000001",
      "feeE8": 1,
      "fromAddress": "1711cadfe5a66a5f5f245fc78b2335f79da362178a72de2e",
      "nonceId": 131630562,
      "pinHeight": 366688,
      "toAddress": "8733d0e21bc791f44785f02753bb589b8423eb56cd938fbc",
      "txHash": "f364da997bf7a3c3bc8ead22041509228d6bdea39fcbcdc6be56030433d54219"
     }
    ]
   }
  },
  {
   "confirmations": 298316,
   "height": 78333,
   "transactions": {
    "rewards": [
     {
      "amount": "3.00000000",
      "amountE8": 300000000,
      "toAddress": "8733d0e21bc791f44785f02753bb589b8423eb56cd938fbc",
      "txHash": "bc1b3a369c63884b013ff798ecb1d964685706d25bfaa8519d301779a6566b2a"
     }
    ],
    "transfers": []
   }
  },
  .
  .
  .
 ]
}
}

GET /account/richlist/:token

Show richlist for a specific token.

TODO: Add JSON output example

GET /peers/ip_count

Show count of connections per IP address.

TODO: Add JSON output example

GET /peers/banned

Show list of banned peers.

TODO: Add JSON output example

GET /peers/offenses/:page

Show paginated list of peer offenses.

TODO: Add JSON output example

GET /peers/connected/connection

Show connection information of connected peers.

TODO: Add JSON output example

GET /peers/connection_schedule

Show the connection schedule for peers.

TODO: Add JSON output example

GET /peers/unban

Unban all banned peers.

TODO: Add JSON output example

GET /peers/connected

Show detailed information about connected peers.

TODO: Add JSON output example

GET /peers/disconnect/:id

Disconnect a specific peer by connection ID.

TODO: Add JSON output example

GET /peers/throttled

Show throttled peers.

TODO: Add JSON output example

GET /peers/transmission_hours

Show transmission statistics aggregated by hours.

TODO: Add JSON output example

GET /peers/transmission_minutes

Show transmission statistics aggregated by minutes.

TODO: Add JSON output example

GET /tools/encode16bit/from_e8/:feeE8

Round raw fee integer representation (coin amount is this number divided by 10^8) to closest 16 bit representation. This is required for fee specification in the /transaction/add endpoint. Example output of /tools/encode16bit/from_e8/5002

{
 "code": 0,
 "data": {
  "16bit": 12514,
  "originalAmount": "0.00005002",
  "originalE8": 5002,
  "roundedAmount": "0.00005000",
  "roundedE8": 5000
 }
}

GET /tools/encode16bit/from_string/:string

Round fee amount string to closest 16 bit representation. This is required for fee specification in the /transaction/add endpoint. Example output of /tools/encode16bit/from_string/0.001:

{
 "code": 0,
 "data": {
  "16bit": 16922,
  "originalAmount": "0.00100000",
  "originalE8": 100000,
  "roundedAmount": "0.00099968",
  "roundedE8": 99968
 }
}

GET /tools/parse_price/:price/:precision

Parse price adjusted for asset precision.

Example output of /tools/parse_price/0.123456/3:

{
 "code": 0,
 "data": {
  "assetPrecision": 3,
  "ceil": {
   "doubleAdjusted": 0.12345750000000001,
   "doubleRaw": 12345.75,
   "exponent2": -2,
   "hex": "c0e74d",
   "mantissa": 49383,
   "precExponent10": 5
  },
  "floor": {
   "doubleAdjusted": 0.12345500000000001,
   "doubleRaw": 12345.5,
   "exponent2": -2,
   "hex": "c0e64d",
   "mantissa": 49382,
   "precExponent10": 5
  }
 }
}

GET /tools/info

Print information about this node.

Example output of /tools/info:

{
 "code": 0,
 "data": {
  "chainDBPath": "/home/user/.warthog/chain_defi.db3",
  "dbSize": 3058028544,
  "peersDBPath": "/home/user/.warthog/peers_v2.db3",
  "rxtxDBPath": "/home/user/.warthog/rxtx.db3",
  "uptime": {
   "formatted": "0d 0h 6m 8s",
   "seconds": 368,
   "sinceTimestamp": 1763453691,
   "sinceUTC": "2025-11-18 08:14:51 UTC"
  },
  "version": {
   "commit": "dd054a2",
   "major": 0,
   "minor": 10,
   "name": "v0.10.3 \"dd054a2\"",
   "patch": 3
  }
 }
}

GET /tools/wallet/new

Create a new wallet.

Example output of /tools/wallet/new:

{
 "code": 0,
 "data": {
  "address": "11c6c0f7148a845cc899360a38fa839ba3d5e719293bb5c6",
  "privKey": "d711913bea313c7a9007e115a5969d9e1127f119d7ec72b3d713f698ab591488",
  "pubKey": "03a907038c8aba55cecf71b242c18d4c92e2a37ff83b8779444f10ceb720fe4551"
 }
}

GET /tools/wallet/from_privkey/:privkey

Restore wallet from a private key.

Example output of /tools/wallet/from_privkey/d3ce2210adf0fccabe31b61309e2b80c029a7e4e305aeed29432edd428d35c3d:

{
 "code": 0,
 "data": {
  "address": "31bfdc6b23b22130edc05073cffa29be793a32518769180e",
  "privKey": "d3ce2210adf0fccabe31b61309e2b80c029a7e4e305aeed29432edd428d35c3d",
  "pubKey": "022ad688a8ccc4898b2b923088e9f297785e8852a6bdc33b7e87ffea3d3e63e32b"
 }
}

GET /tools/janushash_number/:headerhex

Show number interpretation of a header's Janushash. Mining corresponds to finding headers with this number smaller than some threshold dictated by the header difficulty.

Example output of /tools/janushash_number/b4e91160d990b7b679234fc7cdc1aefbe11afe9823d6d8d1da7067e9ab0c8d380af405022613b56b379d0b071a4829cc27875f19bb0cb493f3f15aaedade1080e433874b0000000265ce0eb452f36e59:

{
 "code": 0,
 "data": {
  "janushashNumber": 4.315032866502006e-14
 }
}

GET /tools/sample_verified_peers/:number

List verified peers.

Example output of /tools/sample_verified_peers/5:

{
 "code": 0,
 "data": [
  "51.75.21.134:9186",
  "172.241.31.200:19110",
  "51.68.155.69:9186",
  "148.251.181.254:19110",
  "149.102.187.227:9186"
 ]
}

GET /debug/header_download

Show header download status for debugging purposes.

TODO: Add JSON output example

GET /loadtest/block_request/:conn_id

Load test endpoint for block requests.

TODO: Add JSON output example

GET /loadtest/header_request/:conn_id

Load test endpoint for header requests.

TODO: Add JSON output example

GET /loadtest/disable/:conn_id

Disable a load test connection.

TODO: Add JSON output example

GET /debug/fakemine

Generate fake mining data using the default address.

TODO: Add JSON output example

GET /debug/rollback

Rollback the chain by one block.

TODO: Add JSON output example

GET /debug/fakemine/:address

Generate fake mining data for a specific address.

TODO: Add JSON output example

GET /chart/candles/:asset/:interval

Show OHLCV candle data for a specific asset and interval.

Parameters:

Parameter Type Description
:asset integer/string Asset ID (e.g. 7) or hash (e.g. 0e4825efffa294610d2ac376713e3bcc9b53d378e823834b64e5df01f75d3b0c)
:interval string Timeframe: 5m (5 minutes), 1h (1 hour), 1d (1 day)
from Unix timestamp Start time (optional)
to Unix timestamp End time (optional)
n integer Limit number of results (optional, default: 100)

Query parameter rules:

  • Not all three optional parameters (from, to, n) can be specified at the same time.
  • If only from is specified, the earliest entries from from are returned.
  • If only to is specified, the latest entries up to to are returned.
  • If from and to are specified, all entries from from to to are returned.
  • The total number of entries is limited to 200. The default value for n is 100.

Example output of /chart/candles/7/5m:

{
 "code": 0,
 "data": [
  [
   1772265900,          // begin timestamp of the candle
   7,                   // height
   0.09999999999999999, // open
   0.09999999999999999, // high
   0.09999999999999999, // low
   0.09999999999999999, // close
   40.00200000000001,   // asset amount (base)
   4.0002               // WART amount (quote)
  ]
 ]
}

Each candle is a 8-element array: [begin_timestamp, height, open, high, low, close, base, quote].

GET /chart/trades/:asset

Show trade data for a specific asset.

Parameters:

Parameter Type Description
:asset integer/string Asset ID (e.g. 7) or hash (e.g. 0e4825efffa294610d2ac376713e3bcc9b53d378e823834b64e5df01f75d3b0c)
from block height Start block (optional)
to block height End block (optional)
n integer Limit number of results (optional, default: 100)

Query parameter rules:

  • Not all three optional parameters (from, to, n) can be specified at the same time.
  • If only from is specified, the earliest entries from from are returned.
  • If only to is specified, the latest entries up to to are returned.
  • If from and to are specified, all entries from from to to are returned.
  • The total number of entries is limited to 200. The default value for n is 100.

Example output of /chart/trades/7:

{
 "code": 0,
 "data": [
  [
   7,                 // height
   1772266091,        // timestamp of the block containing the trade
   40.00200000000001, // total asset amount traded in the block
   4.0002             // total WART amount traded in the block
  ]
 ]
}

Each trade is a 4-element array: [height, timestamp, base, quote].