Diagnostics - Bebop API Docs

Use /maker-status as your self-test loop: poll it until the response returns ok: true. Bebop only enables a maker in production once /maker-status passes. The endpoint reports:

Connection status for each WebSocket (levels, quotes, trades).
Levels currently streamed per pair.
Balances and allowances for every token you stream.
Results from a rotating set of test quote requests drawn from your streamed tokens.

A status: ok response means the integration is healthy. Otherwise the payload pinpoints what failed and includes the expected signable_message on signature tests.

Test types

Test	What it validates	Common fix if it fails
`ONE_TO_ONE`	Baseline quote for a single taker token → single maker token.	Ensure your maker is streaming pricing and has approvals + inventory on the settlement contract.
`ONE_TO_ONE_WITH_FEE`	Fee applied correctly; `reference_price` stays pre-fee.	Subtract `fee_native` from `maker_amount`; set `reference_price` to your pre-fee price. See Quotes › Responding.
`ONE_TO_MANY`	Split quote: one taker token → multiple maker tokens.	Support multi-token response shape.
`ONE_TO_MANY_WITH_FEE`	Multi-leg fee allocation by taker-amount ratio.	Split fee proportionally across legs. See Fees › Splitting fees across multi-token trades.
`MANY_TO_ONE`	Split quote: multiple taker tokens → one maker token.	Support multi-token response shape.
`MIDDLE_TOKEN_SIGNING_ONLY`	Signature construction for a `121` quote routed as `MultiOrder` via a middle token.	Preserve per-leg token and amount lists in the signable message; compare against `signable_message` in the response. See Signing › Middle-token routing.

Base URL

https://api.bebop.xyz

Endpoint

GET /pmm/{chain_name}/v3/maker-status

Query parameters

Name	Type	Required	Description
`maker`	string	Yes	The maker identifier as per your credentials (e.g. `maker-rfqt-test`).
`size_usd`	number	No	Notional trade size in USD for the quote tests. Default: `100`.

Headers

Name	Type	Required	Description
`Authorization`	string	Yes	`Bearer <API_KEY>` as per your credentials.

Example

curl -X GET "https://api.bebop.xyz/pmm/ethereum/v3/maker-status?maker=maker-rfqt-test" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Example response
Field definitions

{
  "ok": false,
  "enabled": false,
  "emoji": "🧙‍♂️🧪T",
  "maker_address": "0x..",
  "connections": {
    "levels_client": "CONNECTED",
    "quotes_client": "CONNECTED",
    "trades_client": "DISCONNECTED"
  },
  "levels": {
    "USDC/USDT": {
      "base_address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "quote_address": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
      "asks_amount_total": "2,169,235.86623",
      "asks_amount_total_usd": "2.17M",
      "bids_amount_total": "633,731.13163",
      "bids_amount_total_usd": "632.78K",
      "price": 0.9999500499999999,
      "last_update": "2025-08-05 20:43:53 +0000"
    }
  },
  "token_info": {
    "0xaf88d065e77c8cC2239327C5EDb3A432268e5831": {
      "allowance": 1.157920892373162e+77,
      "balance": 500000000,
      "allowance_decimal": "115,792,089,237,316,195,423,570,985,008,687,907,853,269,984,665,640,000,000,000,000,000,000,000",
      "balance_decimal": "500",
      "router_limit": "499.5"
    }
  },
  "quotes": [
    {
      "test_type": "ONE_TO_ONE",
      "request": "50.011 USDC <-> USDT",
      "success": true,
      "quote_id": "121-216493590260357491556760020260958997180",
      "sell_tokens": {
        "0xaf88d065e77c8cC2239327C5EDb3A432268e5831": {
          "amount": "50011402",
          "decimals": 6,
          "priceUsd": 0.999772,
          "symbol": "USDC",
          "price": 0.9989000908232887,
          "priceBeforeFee": 0.9989000908232887
        }
      },
      "buy_tokens": {
        "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": {
          "amount": "49956394",
          "decimals": 6,
          "priceUsd": 0.999812,
          "symbol": "USDT",
          "minimumAmount": "49956394",
          "price": 1.0011011203090439,
          "priceBeforeFee": 1.0011011203090439,
          "amountBeforeFee": "49956394"
        }
      },
      "total_sell_amount_usd": "50.000",
      "total_buy_amount_usd": "49.947",
      "delta_from_levels_bps": [0]
    }
  ]
}

Field	Type	Description
`ok`	boolean	Overall success of the maker status check.
`enabled`	boolean	Whether the maker is enabled in production or is in test mode.
`emoji`	string	Emoji label for UI obfuscation purposes.
`maker_address`	string	Maker address streamed in the pricing updates.

`connections`

Status of the maker’s WebSocket connections.

Field	Type	Description
`levels_client`	string	Status of levels feed client (`CONNECTED`, `DISCONNECTED`).
`quotes_client`	string	Status of quote service connection.
`trades_client`	string	Status of trade feed client.

`levels`

Information about pricing data being streamed.

Field	Type	Description
`base_address`	string	Address of the base token.
`quote_address`	string	Address of the quote token.
`asks_amount_total`	string	Total ask volume available.
`asks_amount_total_usd`	string	USD value of total asks.
`bids_amount_total`	string	Total bid volume available.
`bids_amount_total_usd`	string	USD value of total bids.
`price`	number	Mid-price between bid and ask.
`last_update`	string	Timestamp of the last levels update.

`token_info`

Token balance and approval limits.

Field	Type	Description
`allowance`	number	Raw token allowance (may be max uint256).
`balance`	number	Raw token balance.
`allowance_decimal`	string	Human-readable allowance (decimal adjusted).
`balance_decimal`	string	Human-readable balance (decimal adjusted).
`router_limit`	string	Minimum between balances and approvals, adjusted to allow some margin. Bebop’s internal router caps your book at `router_limit` regardless of what you stream, to prevent unexecutable quotes.

`quotes`

Result of internal test quotes.

Field	Type	Description
`test_type`	string	Type of test (e.g. `ONE_TO_ONE`, `ONE_TO_MANY_WITH_FEE`).
`request`	string	Description of test quote attempted.
`success`	boolean	Whether the quote succeeded.
`error`	string \| null	Error message if the test failed.

If success is true, additional fields:

Field	Type	Description
`quote_id`	string	Unique identifier of the quote.
`sell_tokens` / `buy_tokens`	object	Token address → trade detail.
`amount`	string	Raw amount (in smallest unit).
`decimals`	number	Token decimals.
`priceUsd`	number	Price in USD.
`price`	number	Implied exchange rate.
`priceBeforeFee`	number	Exchange rate before fees.
`amountBeforeFee`	string	Amount before fees (calculated).
`minimumAmount`	string	Minimum guaranteed amount after fees.
`total_sell_amount_usd`	string	USD value of what was offered.
`total_buy_amount_usd`	string	USD value of what was returned.
`delta_from_levels_bps`	array	Difference from live levels in basis points.
`fee_usd`	string \| null	USD fee applied to the quote (if any).

​Test types

​Query parameters

​Headers

​Example

​Response

​connections

​levels

​token_info

​quotes