Choose a function

This guide covers Orderbook Audit. You can also explore WhaleScope historical signals, Crypto Snapshot, Crypto Trend or Macro Context without a wallet or payment.

Agents can discover function names, parameters and access scope at /v1/tools. API docs include the new response schemas. ACP and MCP execution are not connected.

1. Inspect the free example

Open the public service contract. Its example.input and example.output show the synthetic request and expected calculation. This is a stored example, not a new analysis request, and opening it does not charge or prompt your wallet.

This example buys 0.03 BTC using asks of 0.01 BTC at $100,000 and 0.04 BTC at $100,100. The taker fee is 5 basis points (0.05%). All prices are synthetic USD values.

{
  "base": "BTC",
  "quote": "USD",
  "snapshot_at": "2026-09-05T02:00:00Z",
  "side": "buy",
  "amount_base": "0.03",
  "taker_fee_bps": "5",
  "max_age_ms": 10000,
  "bids": [
    {
      "price": "99900",
      "size": "0.1"
    }
  ],
  "asks": [
    {
      "price": "100000",
      "size": "0.01"
    },
    {
      "price": "100100",
      "size": "0.04"
    }
  ]
}

The first 0.01 BTC fills at $100,000 and the remaining 0.02 BTC at $100,100. Principal: 1000 + 2002 = 3002. Fee: 3002 × 5 / 10000 = 1.501. Expected economic fields:

{
  "requested_base": "0.03",
  "filled_base": "0.03",
  "unfilled_base": "0",
  "fully_fillable": true,
  "levels_used": 2,
  "gross_quote_for_filled": "3002",
  "fee_quote_for_filled": "1.501",
  "cash_quote_for_filled": "3003.501",
  "cash_direction": "pay"
}

Decimal amounts are JSON strings to preserve precision. The landing page rounds USD amounts to cents; the API returns the exact calculated decimals. The USD trade estimate is separate from the API's 0.01 test USDC fee.

The contract example uses a fixed analysis clock of 2026-09-05T02:00:01Z, so its snapshot age is 1,000 ms and freshness is fresh. A request with the same old timestamp today will be labeled stale. The test payment page refreshes the synthetic timestamp before requesting its quote; freshness and age still depend on the actual processing time.

2. Run the testnet flow yourself

1. Open the test payment page in an up-to-date Chrome browser with MetaMask installed.
2. If needed, get free test USDC from the Circle Faucet, selecting Base Sepolia. Do not buy or bridge real funds for this trial.
3. Click 1. Connect wallet and review MetaMask's Base Sepolia network request. After connection succeeds, click 2. Get free quote; wallet connection alone does not submit the analysis.
4. Review the recipient, synthetic input and 0.01 test USDC quote. Click 3. Sign & pay 0.01 test USDC only when you are ready, and approve the signature yourself in MetaMask.
5. Read the displayed result and receipt. Compare the economic fields with the example above. A complete test returns an analysis and a settlement response with success: true on eip155:84532.

This guide never opens a wallet prompt. The test page requests wallet actions only after you click its buttons. If a submission has an unclear outcome, preserve the result and receipt and ask for help before retrying. The page blocks further signing after a submission to reduce duplicate payments. A settlement response is not a separate onchain verification.

3. Share your result and use case

We are recruiting two independent developers to complete the testnet flow and assess whether the result would help an agent, replay tool or orderbook checker. Reading the example, connecting a wallet or receiving faucet tokens alone does not count as a completed trial.

Reply in the existing CDP Discord discussion (community access required) or the public X trial thread. Include:

• Whether you received both the calculation and a successful settlement response, or the step and error where you stopped.
• Whether the expected amounts matched your result, and any discrepancy with your own calculation.
• Your use case and whether you would call a hosted API again or prefer a local library.

Public feedback should contain only non-sensitive details. Do not post seed phrases, private keys, exchange credentials, payment signatures or confidential orderbooks. Share the error text rather than a full wallet screenshot.

For an agent integration

The OpenAPI schema and service contract describe POST /v1/orderbook-audit. Valid unpaid requests to the testnet endpoint return HTTP 402 with the payment requirements. The browser trial is the guided way to exercise that flow today; viewing the docs does not authorize payment.

The result is an estimate from the supplied snapshot. It does not include FX, transfers or exchange lot-size rounding and cannot guarantee execution. This preview is not intended for latency-critical trading.