Views

Call views with NEAR JSON-RPC query / call_function (finality: "final" or "optimistic") on hexbook.near, args as base64 JSON. Amounts are decimal strings, prices raw decimal strings, hashes 64 hex characters, timestamps u64 nanoseconds (they exceed 2^53: parse them as big integers).

curl -s https://rpc.mainnet.near.org -H 'content-type: application/json' -d '{
  "jsonrpc":"2.0","id":"1","method":"query",
  "params":{"request_type":"call_function","finality":"final","account_id":"hexbook.near",
            "method_name":"get_active_pairs","args_base64":"e30="}}' \
  | jq -r '.result.result | implode' | jq

Order book

get_orderbook({ token_pair, depth?, with_extra? }) returns the live orders of both sides, best price first, time priority inside a level. Dead orders (expired or stale epoch) are hidden.

Arg	Type	Notes
`token_pair`	`{ base, quote }`
`depth`	number	max orders per side (not levels); default all
`with_extra`	bool	include `owner` and `created_ts`

{
  "asks": [
    { "price": "0.00014", "order_balance": "10000000000", "hash": "3ed65e74…", "owner": "3e5b3146…", "created_ts": 1791764786216108398 }
  ],
  "bids": [
    { "price": "0.000138", "order_balance": "780000", "hash": "ade2a57f…" }
  ]
}

order_balance is base units for asks, quote units for bids. Group by price to get levels. depth_ask({ token_pair, limit?, with_extra? }) and depth_bid({ token_pair, limit?, with_owner? }) return one side the same way. Single orders:

View	Returns
`get_order({ token_pair, hash })`	`{ hash, order: { side, maker, price, token_pair, created_ts }, order_balance }` or `null`
`get_orders_by_hash({ token_pair, hashes })`	the same per hash
`get_orders_by_owner({ token_pair, owner_id, skip?, limit? })`	an owner’s orders, sorted by hash
`get_orders({ token_pair, skip?, limit? })`	every order of the book

These return every stored order, dead ones included. Use order liveness to tell them apart.

Active pairs

get_active_pairs() lists every book with its config.

[
  {
    "token_pair": { "base": "nep141:qtc.omft.near", "quote": "nep141:usdt.tether-token.near" },
    "volume": { "sell": "10000000000", "buy": "780000" },
    "protocol_fee": {
      "taker_fee_collectors": [ { "fee": 500, "collector": "mhga.near" } ],
      "maker_fee_collectors": []
    },
    "min_order_amount": { "base": "1000000000", "quote": "100000" },
    "tick_size": "0.0000001"
  }
]

volume: the total resting balance per side (sell in base units, buy in quote units), dead orders not yet closed included. Not traded volume.
fee is in pips (500 = 0.05%).
min_order_amount: raw units, base for asks, quote for bids. tick_size: raw price step, "0" = none.

For one book: get_book_config({ token_pair }) → { token_pair, fee_config, min_order_amount, tick_size }, get_protocol_fee({ token_pair }), get_volume({ token_pair }).

Quote

get_quote_pub({ ext, amount, token_id, order_placement_action, taker_id? }) simulates an order exactly as mt_on_transfer would execute it.

Arg	Type	Notes
`ext`	`{ refs, max_fills?, expires_at? }`	same as in the order `msg` (the tick and expiry are checked as in execution)
`amount`	u128 string	what the taker sends
`token_id`	string	the token sent (base = sell, quote = buy)
`order_placement_action`	`{ token_pair, order_type, price? \| min_amount_out? \| exact_amount_out?, post_only? }`	the order fields of the `msg`
`taker_id`	account	sizes the trade’s log as in execution, and checks the taker’s 200-order cap for a resting remainder (at the cap the remainder is refunded); without it the quote assumes a 64-character account with no orders

{
  "book_fill_result": {
    "taker_type": { "order_type": "limit", "price": "0.00014", "post_only": false },
    "taker_side": "buy",
    "token_pair": { "base": "nep141:qtc.omft.near", "quote": "nep141:usdt.tether-token.near" },
    "taker_receive_total": "4997500000",
    "taker_unspent": "0",
    "makers_receive_total_by_account": { "3e5b3146…": "699650" },
    "updated_balance_by_order": { "3ed65e74…": "5002500000" },
    "order_decrease_balance": { "3ed65e74…": "4997500000" },
    "taker_fee_quote": "350",
    "makers_total_fee_quote": "0",
    "fee_config": { "taker_fee_collectors": [ { "fee": 500, "collector": "mhga.near" } ], "maker_fee_collectors": [] },
    "truncated": false,
    "fills": [ { "hash": "3ed65e74…", "base": "4997500000", "quote": "699650", "maker_fee": "0", "left": "5002500000" } ]
  },
  "taker_remainder": null,
  "increase_user_balance": {
    "nep141:qtc.omft.near": { "9b5d0c42…": "4997500000" },
    "nep141:usdt.tether-token.near": { "3e5b3146…": "699650", "mhga.near": "350" }
  },
  "closed_orders": []
}

Field	Meaning
`book_fill_result.taker_receive_total`	what the taker receives
`book_fill_result.taker_fee_quote` / `makers_total_fee_quote`	fees in quote units
`book_fill_result.fills`	every maker order met, in order: base, quote, maker fee and the balance `left`
`book_fill_result.truncated`	the fill stopped at `max_fills`, the log budget or a level the taker cannot buy one unit of; the rest is refunded
`book_fill_result.fills[].dead`	`true` for a dead order met: not filled, closed with its whole balance (omitted when false)
`book_fill_result.internal_makers`	makers in payout mode `internal` met by the trade (omitted when empty)
`taker_remainder`	`null`, `{ "new_order": "<amount>" }` (rests in the book) or `{ "refund": "<amount>" }`
`closed_orders`	maker orders the trade closes with a refund, dead ones included: `[{ hash, refund }]`
`increase_user_balance`	every credit by token and account (taker, makers, fee collectors, refunds)
`internal_credits`	the part of `increase_user_balance` credited to internal balances instead of paid out: `[{ token_id, account_id, amount }]` (omitted when empty)

Whatever would make the execution panic (post-only that would take, min_amount_out not met, off-tick price, past expires_at) makes the view panic with the same error.

User balance

get_user_balance({ account_id }) → { "<token_id>": "<amount>" }: the account’s internal balance. get_user_balances({ skip?, limit? }) lists every account.

Payout mode

get_payout_mode({ account_id }) → "intents" (default) or "internal".

Epoch

get_epoch({ token_pair, account_id }) → the account’s current epoch in the book (0 until its first cancel_all or bump_epoch).

Order liveness

is_order_live({ token_pair, hash }) → true when the order rests, is not expired at this block and its epoch equals its maker’s current epoch; false otherwise (unknown, closed, expired or stale epoch). get_order_meta({ token_pair, hash }) → { epoch, expires_at, maker_epoch, live } for a resting order, or null (expires_at 0 = never).

Overview

Contract

Market making

Indexing

Order book

Active pairs

Quote

User balance

Payout mode

Epoch

Order liveness

​Order book

​Active pairs

​Quote

​User balance

​Payout mode

​Epoch

​Order liveness

Order book

Active pairs

Quote

User balance

Payout mode

Epoch

Order liveness