ToolVet
77trust / 100

Orderbook

by Order Book Depth & Slippage in Markets & finance

x402 APIPassing, checked 2 h ago

Order book depth of one coin's perpetual on Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit and OKX: best bid/ask, spread in bps, market depth in USD within 0.1/0.5/1/2% of mid, bid/ask imbalance, estimated slippage for your order size and the largest resting orders (walls). L2 orderbook liquidity for BTC, ETH, SOL and more. Data only. Bad input is free; under 2 venues not charged.

GET
https://derivs.duoleads.com/v1/orderbook
Price
$0.003
per call in USDC
Uptime
100%
last 30 days
Response time
384 ms
587 ms slowest 5%
Last check
Passed
2 h ago, next any minute now

Run a free test callHow to call it

Reliability

All checks passedSome failedAll failedNot checked

Status and outage history · Atom feed · Watch with other listings

How to call it

GET https://derivs.duoleads.com/v1/orderbook

Each call costs $0.003 in USDC on Base, paid with the request over x402.

Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.

Example request

From the listing.

GET https://derivs.duoleads.com/v1/orderbook?coin=BTC&size_usd=100000

Parameters

ParameterTypeRequiredDescription
coinstringYesCoin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE).
levelsstringNoAlso return the top N price levels per side (0-20). Default 0. Default: "0".
size_usdstringNoOrder size in USD for the slippage estimate (1-1e9). Default 100000. Default: "100000".

Example response

The provider's example. We can't check it without paying.

Example response, 254 lines
{
  "aggregate": {
    "depth": [
      {
        "ask_usd": 42793969.58,
        "bid_usd": 41381002.89,
        "imbalance": -0.0167861,
        "pct": 0.1
      },
      {
        "ask_usd": 104580954.7,
        "bid_usd": 109389514.7,
        "imbalance": 0.022473,
        "pct": 0.5
      }
    ],
    "lowest_buy_slippage": {
      "value": 0.00612408,
      "venue": "bybit"
    },
    "lowest_sell_slippage": {
      "value": 0.00612408,
      "venue": "bybit"
    },
    "tightest_spread": {
      "value": 0.0122482,
      "venue": "bybit"
    }
  },
  "as_of": "2026-10-14T23:00:00Z",
  "coin": "BTC",
  "colo": null,
  "disclaimer": "Data only, not investment advice, not a benchmark; not affiliated with any exchange",
  "request_id": "01KEXAMPLE0000000000000000",
  "see_also": {
    "endpoint": "https://derivs.duoleads.com/v1/liquidations",
    "params": [
      "coin",
      "hours"
    ],
    "reason": "Recent forced liquidations that hit these books."
  },
  "size_usd": 100000,
  "units": {
    "depth_usd": "USD resting within +/- pct % of mid (price x size)",
    "imbalance": "(bid_usd - ask_usd) / (bid_usd + ask_usd), -1..1",
    "levels": "[price USD, size coins]",
    "prices": "USD per coin",
    "slippage_bps": "average fill vs mid in basis points (>= 0 is worse than mid)",
    "spread_bps": "(ask - bid) / mid x 10,000",
    "times": "ISO 8601 UTC"
  },
  "venues": [
    {
      "as_of": "2026-10-14T23:00:00Z",
      "best_ask": 81645,
      "best_bid": 81644.9,
      "book_time": "2026-10-14T22:50:24Z",
      "depth": [
        {
          "ask_usd": 7913202.056,
          "bid_usd": 8009555.947,
          "imbalance": 0.00605133,
          "pct": 0.1
        },
        {
          "ask_usd": 7913202.056,
          "bid_usd": 8009555.947,
          "imbalance": 0.00605133,
          "pct": 0.5
        }
      ],
      "levels_held": {
        "asks": 200,
        "bids": 200
      },
      "mid": 81644.95,
      "slippage": {
        "buy": {
          "avg_price": 81645,
          "filled": true,
          "filled_usd": 100000,
          "slippage_bps": 0.00612408
        },
        "sell": {
          "avg_price": 81644.9,
          "filled": true,
          "filled_usd": 100000,
          "slippage_bps": 0.00612408
        },
        "size_usd": 100000
      },
      "spread_bps": 0.0122482,
      "stale": false,
      "symbol": "BTCUSDT",
      "venue": "bybit",
      "walls": {
        "asks": [
          {
            "price": 81672,
            "size_usd": 510695.016
          },
          {
            "price": 81669.3,
            "size_usd": 452692.9299
          }
        ],
        "bids": [
          {
            "price": 81634.1,
            "size_usd": 642378.7329
          },
          {
            "price": 81644.9,
            "size_usd": 483174.5182
          }
        ]
      }
    },
    {
      "as_of": "2026-10-14T23:00:00Z",
      "best_ask": 81649,
      "best_bid": 81648,
      "book_time": "2026-10-14T22:50:37Z",
      "depth": [
        {
          "ask_usd": 5325002.521,
          "bid_usd": 5932686.945,
          "imbalance": 0.0539795,
          "pct": 0.1
        },
        {
          "ask_usd": 5325002.521,
          "bid_usd": 5932686.945,
          "imbalance": 0.0539795,
          "pct": 0.5
        }
      ],
      "levels_held": {
        "asks": 20,
        "bids": 20
      },
      "mid": 81648.5,
      "slippage": {
        "buy": {
          "avg_price": 81649,
          "filled": true,
          "filled_usd": 100000,
          "slippage_bps": 0.0612381
        },
        "sell": {
          "avg_price": 81648,
          "filled": true,
          "filled_usd": 100000,
          "slippage_bps": 0.0612381
        },
        "size_usd": 100000
      },
      "spread_bps": 0.122476,
      "stale": false,
      "symbol": "BTC",
      "venue": "hyperliquid",
      "walls": {
        "asks": [
          {
            "price": 81649,
            "size_usd": 735450.918
          },
          {
            "price": 81665,
            "size_usd": 702384.332
          }
        ],
        "bids": [
          {
            "price": 81630,
            "size_usd": 1456431.848
          },
          {
            "price": 81631,
            "size_usd": 1080598.526
          }
        ]
      }
    },
    {
      "as_of": "2026-10-14T23:00:00Z",
      "best_ask": 81558,
      "best_bid": 81555,
      "book_time": "2026-10-14T23:00:00Z",
      "depth": [
        {
          "ask_usd": 54982.3292,
          "bid_usd": 432342.3352,
          "imbalance": 0.77435,
          "pct": 0.1
        },
        {
          "ask_usd": 19370916.04,
          "bid_usd": 14526180.35,
          "imbalance": -0.142925,
          "pct": 0.5
        }
      ],
      "levels_held": {
        "asks": 100,
        "bids": 100
      },
      "mid": 81556.5,
      "slippage": {
        "buy": {
          "avg_price": 81629.85356,
          "filled": true,
          "filled_usd": 100000,
          "slippage_bps": 8.9942
        },
        "sell": {
          "avg_price": 81533.36734,
          "filled": true,
          "filled_usd": 100000,
          "slippage_bps": 2.8364
        },
        "size_usd": 100000
      },
      "spread_bps": 0.367843,
      "stale": false,
      "symbol": "BTC-USD",
      "venue": "dydx",
      "walls": {
        "asks": [
          {
            "price": 83219,
            "size_usd": 10000111
          },
          {
            "price": 83178,
            "size_usd": 10000083.37
          }
        ],
        "bids": [
          {
            "price": 80967,
            "size_usd": 8090263.124
          },
          {
            "price": 80845,
            "size_usd": 8078072.823
          }
        ]
      }
    }
  ],
  "venues_missing": []
}

Call it from code

The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.003.

curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://derivs.duoleads.com/v1/orderbook?coin=BTC&size_usd=100000'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://derivs.duoleads.com/v1/orderbook?coin=BTC&size_usd=100000' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode
JavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.003 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.003" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.003 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fderivs.duoleads.com%2Fv1%2Forderbook
const res = await pay("https://derivs.duoleads.com/v1/orderbook?coin=BTC&size_usd=100000");
console.log(res.status, await res.text());
Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.003 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.003"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://derivs.duoleads.com/v1/orderbook?coin=BTC&size_usd=100000")
    print(res.status_code, res.text)

Security scan

No findings

We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
2 h agoPassed402310 ms$0.003
7 h agoPassed402587 ms$0.003
11 h agoPassed402486 ms$0.003
16 h agoPassed402527 ms$0.003
20 h agoPassed402384 ms$0.003
Show 4 older checks
25 h agoPassed402340 ms$0.003
29 h agoPassed402125 ms$0.003
33 h agoPassed402477 ms$0.003
42 h agoPassed402222 ms$0.003