Stats

Protocol monitoring: mint cap, payout queue, side exposure, fee split, fill price age, and short-hold PnL by day; daily activity: per-market volume, liquidations and fills, collateral deposits vs withdrawals, with since-launch totals

Daily activity

get/stats/activity

Query parameters

daysstring
Days of history, today included: canonical decimal (digits only, no sign, whitespace or leading zero), 1 to 18446744073709551615, else 400 bad_request; an empty value is omitted. The service defaults to 90 and serves at most 366.
Pattern^(0|[1-9][0-9]*)$
Example30

Responses

Daily trading activity, indexed from on-chain events: per market and UTC day the volume (notional opened plus notional closed or liquidated, at the positions' open notional, the markets/stats volume24h definition), the liquidated notional and count and the two-step order fills; and the USDC deposited into and withdrawn from trading accounts per day. Each series carries allTime, its since-launch total, so a client can draw the all-time running total under any window (allTime less the days after each day). Every series runs fromDay to toDay, one row per day, zeros on a quiet day. Days are UTC day numbers (ms / 86400000); USDC amounts are base units (6 decimals). Every integer is an n-suffixed decimal string. complete is false while the service is still folding history indexed before these stats existed. 404 from a service revision that does not serve it yet.
application/json
dataStatsActivityrequired
Daily per-market volume, liquidations and fills and collateral deposits vs withdrawals, one row per UTC day (ms / 86_400_000) with since-launch totals.
collateralCollateralActivityrequired
allTimeCollateralFlowrequired
USDC into and out of trading accounts.
daysCollateralFlowDay[]required
daystringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example20794n
depositCountstringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example24n
depositsstringrequired
USDC deposited into trading accounts, base units (6 decimals).
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
withdrawalCountstringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example24n
withdrawalsstringrequired
USDC withdrawn from trading accounts, base units (6 decimals).
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
completebooleanrequired
The rows cover every indexed event (false while the service folds older history).
fromDaystringrequired
First and last day of every days series.
Pattern^-?(0|[1-9][0-9]*)n$
Example20794n
marketsMarketActivity[]required
allTimeMarketFlowrequired
Every indexed flow since launch.
closedNotionalstringrequired
Positions closed or liquidated, at their open notional.
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
fillsstringrequired
Two-step order fills.
Pattern^-?(0|[1-9][0-9]*)n$
Example24n
liquidatedNotionalstringrequired
The liquidated part of closedNotional.
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
liquidationsstringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example24n
openedNotionalstringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
volumestringrequired
Notional opened plus notional closed or liquidated.
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
daysMarketFlowDay[]required
One row per day, fromDay to toDay (zeros on a quiet day).
closedNotionalstringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
daystringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example20794n
fillsstringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example24n
liquidatedNotionalstringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
liquidationsstringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example24n
openedNotionalstringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
volumestringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example1850000000000n
marketIdstringrequired
Pattern^0x[0-9a-f]{64}$
Example0x6e6238eb4f69bfcc3e884a7d20904eb0995ca2e42c95dc8560d5a417486ab645
symbolstring | null
ExampleWTI
nowMsstringrequired
Milliseconds.
Pattern^-?(0|[1-9][0-9]*)n$
Example1796677200000n
toDaystringrequired
Pattern^-?(0|[1-9][0-9]*)n$
Example20794n
application/json
errorErrorObjectrequired
codestringrequired
messagestringrequired
application/json
errorErrorObjectrequired
codestringrequired
messagestringrequired
rate_limited: too many requests from this client IP; retry after Retry-After seconds
application/json
Headers: Retry-After
errorErrorObjectrequired
codestringrequired
messagestringrequired
Bad gateway: the service is temporarily unavailable
application/json
errorErrorObjectrequired
codestringrequired
messagestringrequired

Example request

curl 'https://api.parchment.trade/stats/activity'

const res = await fetch("https://api.parchment.trade/stats/activity");
const { data } = await res.json();

Example response (200)

application/json

{
  "data": {
    "collateral": {
      "allTime": {
        "depositCount": "24n",
        "deposits": "1850000000000n",
        "withdrawalCount": "24n",
        "withdrawals": "1850000000000n"
      },
      "days": [
        {
          "day": "20794n",
          "depositCount": "24n",
          "deposits": "1850000000000n",
          "withdrawalCount": "24n",
          "withdrawals": "1850000000000n"
        }
      ]
    },
    "complete": true,
    "fromDay": "20794n",
    "markets": [
      {
        "allTime": {
          "closedNotional": "1850000000000n",
          "fills": "24n",
          "liquidatedNotional": "1850000000000n",
          "liquidations": "24n",
          "openedNotional": "1850000000000n",
          "volume": "1850000000000n"
        },
        "days": [
          {
            "closedNotional": "1850000000000n",
            "day": "20794n",
            "fills": "24n",
            "liquidatedNotional": "1850000000000n",
            "liquidations": "24n",
            "openedNotional": "1850000000000n",
            "volume": "1850000000000n"
          }
        ],
        "marketId": "0x6e6238eb4f69bfcc3e884a7d20904eb0995ca2e42c95dc8560d5a417486ab645",
        "symbol": "WTI"
      }
    ],
    "nowMs": "1796677200000n",
    "toDay": "20794n"
  }
}

Protocol monitoring

get/stats/monitoring