Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/dripmetrics-ai:dripmetrics-ai-orderbook-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: DripMetrics Orderbook API
version: 1.0.0
description: DripMetricsAI provides on-demand crypto market microstructure, risk, prediction-market, Hyperliquid, and on-chain metrics. Paid endpoints use x402 (USDC on Base or USDG on Robinhood Chain) and return structured JSON without subscriptions or API keys. Also available over MCP (Streamable HTTP) at https://mcp.dripmetrics.ai/mcp with free discovery tools.
x-mcp: https://mcp.dripmetrics.ai/mcp
x-guidance: 'Use /openapi.json for discovery. Routes with x-payment-info are x402-paid resources: first call the endpoint without PAYMENT-SIGNATURE to receive a 402 challenge, then retry with a valid x402 v2 PAYMENT-SIGNATURE. Routes with security: [] are public discovery or health routes and should not be probed for payment.'
contact:
email: drip@dripmetrics.ai
url: https://dripmetrics.ai/
servers:
- url: https://api.dripmetrics.ai
tags:
- name: Orderbook
paths:
/orderbook/spread:
get:
operationId: getOrderbookSpread
summary: Compute order-book spread
description: Computes an order-book microstructure metric from a fresh Binance depth snapshot fetched per request. Invalid or unsupported requests, and requests that exceed the fetched book depth, fail before payment.
tags:
- Orderbook
parameters:
- name: pair
in: query
required: false
description: Binance-native pair. BTCUSDT, ETHUSDT, and SOLUSDT are supported.
schema:
type: string
enum:
- BTCUSDT
- ETHUSDT
- SOLUSDT
default: BTCUSDT
security:
- x402: []
x-payment-info:
price:
fixed:
mode: fixed
currency: USD
amount: '0.05'
protocols:
- x402: {}
x-dripmetrics-paid: true
x-x402:
priceUsd: '0.05'
asset: USDC
network: eip155:8453
scheme: exact
paymentOptions:
- network: eip155:8453
asset: USDC
scheme: exact
- network: eip155:4663
asset: USDG
scheme: exact
responses:
'200':
description: Successful paid response.
content:
application/json:
schema:
$ref: '#/components/schemas/OrderbookMetricResult'
'400':
$ref: '#/components/responses/BadRequest'
'402':
$ref: '#/components/responses/PaymentRequired'
'422':
$ref: '#/components/responses/MetricNotComputable'
'503':
$ref: '#/components/responses/UpstreamUnavailable'
/orderbook/micro-price:
get:
operationId: getOrderbookMicroPrice
summary: Compute order-book micro-price
description: Computes an order-book microstructure metric from a fresh Binance depth snapshot fetched per request. Invalid or unsupported requests, and requests that exceed the fetched book depth, fail before payment.
tags:
- Orderbook
parameters:
- name: pair
in: query
required: false
description: Binance-native pair. BTCUSDT, ETHUSDT, and SOLUSDT are supported.
schema:
type: string
enum:
- BTCUSDT
- ETHUSDT
- SOLUSDT
default: BTCUSDT
security:
- x402: []
x-payment-info:
price:
fixed:
mode: fixed
currency: USD
amount: '0.05'
protocols:
- x402: {}
x-dripmetrics-paid: true
x-x402:
priceUsd: '0.05'
asset: USDC
network: eip155:8453
scheme: exact
paymentOptions:
- network: eip155:8453
asset: USDC
scheme: exact
- network: eip155:4663
asset: USDG
scheme: exact
responses:
'200':
description: Successful paid response.
content:
application/json:
schema:
$ref: '#/components/schemas/OrderbookMetricResult'
'400':
$ref: '#/components/responses/BadRequest'
'402':
$ref: '#/components/responses/PaymentRequired'
'422':
$ref: '#/components/responses/MetricNotComputable'
'503':
$ref: '#/components/responses/UpstreamUnavailable'
/orderbook/imbalance:
get:
operationId: getOrderbookImbalance
summary: Compute order-book imbalance
description: Computes an order-book microstructure metric from a fresh Binance depth snapshot fetched per request. Invalid or unsupported requests, and requests that exceed the fetched book depth, fail before payment.
tags:
- Orderbook
parameters:
- name: pair
in: query
required: false
description: Binance-native pair. BTCUSDT, ETHUSDT, and SOLUSDT are supported.
schema:
type: string
enum:
- BTCUSDT
- ETHUSDT
- SOLUSDT
default: BTCUSDT
- name: depthLevels
in: query
required: false
description: Number of book levels per side to include.
schema:
type: integer
minimum: 1
maximum: 50
default: 10
security:
- x402: []
x-payment-info:
price:
fixed:
mode: fixed
currency: USD
amount: '0.05'
protocols:
- x402: {}
x-dripmetrics-paid: true
x-x402:
priceUsd: '0.05'
asset: USDC
network: eip155:8453
scheme: exact
paymentOptions:
- network: eip155:8453
asset: USDC
scheme: exact
- network: eip155:4663
asset: USDG
scheme: exact
responses:
'200':
description: Successful paid response.
content:
application/json:
schema:
$ref: '#/components/schemas/OrderbookMetricResult'
'400':
$ref: '#/components/responses/BadRequest'
'402':
$ref: '#/components/responses/PaymentRequired'
'422':
$ref: '#/components/responses/MetricNotComputable'
'503':
$ref: '#/components/responses/UpstreamUnavailable'
/orderbook/depth-at-distance:
get:
operationId: getOrderbookDepthAtDistance
summary: Compute order-book depth-at-distance
description: Computes an order-book microstructure metric from a fresh Binance depth snapshot fetched per request. Invalid or unsupported requests, and requests that exceed the fetched book depth, fail before payment.
tags:
- Orderbook
parameters:
- name: pair
in: query
required: false
description: Binance-native pair. BTCUSDT, ETHUSDT, and SOLUSDT are supported.
schema:
type: string
enum:
- BTCUSDT
- ETHUSDT
- SOLUSDT
default: BTCUSDT
- name: bpsDistance
in: query
required: false
description: Distance from mid price, in basis points.
schema:
type: number
minimum: 1
maximum: 2000
default: 50
security:
- x402: []
x-payment-info:
price:
fixed:
mode: fixed
currency: USD
amount: '0.10'
protocols:
- x402: {}
x-dripmetrics-paid: true
x-x402:
priceUsd: '0.10'
asset: USDC
network: eip155:8453
scheme: exact
paymentOptions:
- network: eip155:8453
asset: USDC
scheme: exact
- network: eip155:4663
asset: USDG
scheme: exact
responses:
'200':
description: Successful paid response.
content:
application/json:
schema:
$ref: '#/components/schemas/OrderbookMetricResult'
'400':
$ref: '#/components/responses/BadRequest'
'402':
$ref: '#/components/responses/PaymentRequired'
'422':
$ref: '#/components/responses/MetricNotComputable'
'503':
$ref: '#/components/responses/UpstreamUnavailable'
/orderbook/concentration:
get:
operationId: getOrderbookConcentration
summary: Compute order-book concentration
description: Computes an order-book microstructure metric from a fresh Binance depth snapshot fetched per request. Invalid or unsupported requests, and requests that exceed the fetched book depth, fail before payment.
tags:
- Orderbook
parameters:
- name: pair
in: query
required: false
description: Binance-native pair. BTCUSDT, ETHUSDT, and SOLUSDT are supported.
schema:
type: string
enum:
- BTCUSDT
- ETHUSDT
- SOLUSDT
default: BTCUSDT
- name: depthLevels
in: query
required: false
description: Number of book levels per side to include.
schema:
type: integer
minimum: 1
maximum: 50
default: 10
security:
- x402: []
x-payment-info:
price:
fixed:
mode: fixed
currency: USD
amount: '0.10'
protocols:
- x402: {}
x-dripmetrics-paid: true
x-x402:
priceUsd: '0.10'
asset: USDC
network: eip155:8453
scheme: exact
paymentOptions:
- network: eip155:8453
asset: USDC
scheme: exact
- network: eip155:4663
asset: USDG
scheme: exact
responses:
'200':
description: Successful paid response.
content:
application/json:
schema:
$ref: '#/components/schemas/OrderbookMetricResult'
'400':
$ref: '#/components/responses/BadRequest'
'402':
$ref: '#/components/responses/PaymentRequired'
'422':
$ref: '#/components/responses/MetricNotComputable'
'503':
$ref: '#/components/responses/UpstreamUnavailable'
/orderbook/execution-impact:
get:
operationId: getOrderbookExecutionImpact
summary: Compute order-book execution-impact
description: Computes an order-book microstructure metric from a fresh Binance depth snapshot fetched per request. Invalid or unsupported requests, and requests that exceed the fetched book depth, fail before payment.
tags:
- Orderbook
parameters:
- name: pair
in: query
required: false
description: Binance-native pair. BTCUSDT, ETHUSDT, and SOLUSDT are supported.
schema:
type: string
enum:
- BTCUSDT
- ETHUSDT
- SOLUSDT
default: BTCUSDT
- name: side
in: query
required: true
description: Direction of the hypothetical order.
schema:
type: string
enum:
- buy
- sell
- name: sizeBase
in: query
required: false
description: 'Order size in units of the selected pair''s base asset. Bounds: BTC 0.001-50, ETH 0.01-1000, SOL 0.1-50000. Provide exactly one of sizeBase, sizeBtc, or notionalUsd.'
schema:
type: number
minimum: 0.001
maximum: 50000
- name: sizeBtc
in: query
required: false
description: Deprecated alias for sizeBase. Despite its name, it is interpreted as units of the selected pair's base asset.
schema:
type: number
minimum: 0.001
maximum: 50000
deprecated: true
- name: notionalUsd
in: query
required: false
description: Order size in USD notional. Provide exactly one of sizeBase, sizeBtc, or notionalUsd.
schema:
type: number
minimum: 10
maximum: 2000000
security:
- x402: []
x-payment-info:
price:
fixed:
mode: fixed
currency: USD
amount: '0.25'
protocols:
- x402: {}
x-dripmetrics-paid: true
x-x402:
priceUsd: '0.25'
asset: USDC
network: eip155:8453
scheme: exact
paymentOptions:
- network: eip155:8453
asset: USDC
scheme: exact
- network: eip155:4663
asset: USDG
scheme: exact
responses:
'200':
description: Successful paid response.
content:
application/json:
schema:
$ref: '#/components/schemas/OrderbookMetricResult'
'400':
$ref: '#/components/responses/BadRequest'
'402':
$ref: '#/components/responses/PaymentRequired'
'422':
$ref: '#/components/responses/MetricNotComputable'
'503':
$ref: '#/components/responses/UpstreamUnavailable'
/orderbook/snapshot:
get:
operationId: getOrderbookSnapshot
summary: Compute order-book snapshot
description: Computes an order-book microstructure metric from a fresh Binance depth snapshot fetched per request. Invalid or unsupported requests, and requests that exceed the fetched book depth, fail before payment.
tags:
- Orderbook
parameters:
- name: pair
in: query
required: false
description: Binance-native pair. BTCUSDT, ETHUSDT, and SOLUSDT are supported.
schema:
type: string
enum:
- BTCUSDT
- ETHUSDT
- SOLUSDT
default: BTCUSDT
- name: depthLevels
in: query
required: false
description: Number of book levels per side to include.
schema:
type: integer
minimum: 1
maximum: 50
default: 10
- name: bpsDistance
in: query
required: false
description: Distance from mid price, in basis points.
schema:
type: number
minimum: 1
maximum: 2000
default: 50
- name: side
in: query
required: false
description: Direction of the hypothetical order.
schema:
type: string
enum:
- buy
- sell
- name: sizeBase
in: query
required: false
description: 'Order size in units of the selected pair''s base asset. Bounds: BTC 0.001-50, ETH 0.01-1000, SOL 0.1-50000. Provide exactly one of sizeBase, sizeBtc, or notionalUsd.'
schema:
type: number
minimum: 0.001
maximum: 50000
- name: sizeBtc
in: query
required: false
description: Deprecated alias for sizeBase. Despite its name, it is interpreted as units of the selected pair's base asset.
schema:
type: number
minimum: 0.001
maximum: 50000
deprecated: true
- name: notionalUsd
in: query
required: false
description: Order size in USD notional. Provide exactly one of sizeBase, sizeBtc, or notionalUsd.
schema:
type: number
minimum: 10
maximum: 2000000
security:
- x402: []
x-payment-info:
price:
fixed:
mode: fixed
currency: USD
amount: '0.25'
protocols:
- x402: {}
x-dripmetrics-paid: true
x-x402:
priceUsd: '0.25'
asset: USDC
network: eip155:8453
scheme: exact
paymentOptions:
- network: eip155:8453
asset: USDC
scheme: exact
- network: eip155:4663
asset: USDG
scheme: exact
responses:
'200':
description: Successful paid response.
content:
application/json:
schema:
$ref: '#/components/schemas/OrderbookMetricResult'
'400':
$ref: '#/components/responses/BadRequest'
'402':
$ref: '#/components/responses/PaymentRequired'
'422':
$ref: '#/components/responses/MetricNotComputable'
'503':
$ref: '#/components/responses/UpstreamUnavailable'
components:
schemas:
ErrorResponse:
type: object
properties:
error:
type: string
message:
type: string
metric:
type: string
components:
type: object
additionalProperties: true
required:
- error
additionalProperties: true
OrderbookMetricResult:
type: object
properties:
metric:
type: string
enum:
- spread
- micro-price
- imbalance
- depth-at-distance
- concentration
- execution-impact
- snapshot
pair:
type: string
enum:
- BTCUSDT
- ETHUSDT
- SOLUSDT
value:
type:
- number
- 'null'
components:
type: object
additionalProperties: true
sampleSize:
type: object
additionalProperties: true
source:
type: object
additionalProperties: true
computedAt:
type: string
format: date-time
required:
- metric
- pair
- value
- components
- sampleSize
- source
- computedAt
additionalProperties: true
responses:
UpstreamUnavailable:
description: Upstream data source unavailable or insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
PaymentRequired:
description: x402 payment required. Programmatic clients should read payment requirements and retry with a valid PAYMENT-SIGNATURE header.
headers:
PAYMENT-REQUIRED:
description: Base64-encoded x402 v2 payment requirements.
schema:
type: string
PAYMENT-RESPONSE:
description: Base64-encoded x402 payment response after verification or settlement.
schema:
type: string
content:
application/json:
schema:
type: object
additionalProperties: true
MetricNotComputable:
description: Metric could not be computed from available data.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
BadRequest:
description: Invalid request.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
x402:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 v2 payment signature header supplied after reading the 402 PAYMENT-REQUIRED response.