PMM RFQ

HalfMoon PMM RFQ is an institutional request-for-quote service for spot trading on EVM-compatible networks. It enables deterministic execution through professional market makers and supports both aggregated routing and direct per-market-maker integrations.

This documentation is organized for external release and integration. Endpoint-specific request and response tables are the authoritative source for API field definitions.

This documentation is intended for:

• Enterprise API consumers

• Third-party aggregators

• Implementation and joint-testing teams

---

Integration Modes

HalfMoon currently supports two integration models.

Aggregated API Mode

This is the recommended model for most integrations. HalfMoon handles market-maker selection, routing, and quote orchestration on your behalf.

Your application only needs to:

1. Request an indicative quote

2. Request a firm quote

3. Submit the returned calldata on-chain

This model does not require:

• WebSocket depth subscription

• Protobuf decoding

• Direct handling of RFQ quote signatures

Aggregator Mode

This model is intended for advanced partners that want direct access to per-market-maker liquidity.

Your application is responsible for:

1. Subscribing to per-MM orderbook depth over WebSocket

2. Selecting the market maker to trade with

3. Requesting a single-MM firm quote

4. Decoding rfq_quote_data

5. Constructing and submitting the on-chain transaction to the Settlement or Router contract

6. Reporting the quote_id to tx_hash mapping after broadcast

---

Service Boundary

The following integration inputs must be provided by HalfMoon and must not be mixed with values from any other service:

• HTTP gateway domain

• WebSocket orderbook domain

• business API key

• Returned calldata

• Settlement and Router contract addresses

Reusing credentials, quote payloads, or execution parameters across services is not supported.

---

Supported Networks

The following networks are currently supported in production:

Chain ID	Network
1	Ethereum Mainnet
56	BSC Mainnet
8453	Base Mainnet

---

Contract Addresses

Contract	Ethereum (1)	BSC (56)	Base (8453)
Settlement	0x203e67c384Dbf42aD0556EfFebA30cb2Bda488f9	0x5F86475d57e9B488500d3CdA6F6Cb3938B192077	0x5F86475d57e9B488500d3CdA6F6Cb3938B192077
Router	0x5cDCD41a8aAC737f78B2B2e7E4A8cdaE25Dbd02d	0xC9f8Faab4708F498942aa9a18Ad1AF857e59A3D7	0xEC462c303970BD8175Ef8A43aCE23241359175f9
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	0x000000000022D473030F116dDEE9F6B43aC78BA3	0x000000000022D473030F116dDEE9F6B43aC78BA3

---

External Entry Points

Entry	Purpose
https://rfq.halfmoondex.com	HTTP gateway for listing, aggregated quotes, and single-MM firm quotes
wss://qe.halfmoondex.com/v1/quote/orderbook	WebSocket endpoint for per-MM depth subscription

Before requesting quotes, call the Listing Endpoints to confirm the supported tokens, pairs, and network coverage for your integration.

---

Rate Limits

Rate limits are enforced at multiple levels:

Tier	Limit	Description
Per-IP	100 QPS	Up to 100 requests per second per IP, burst limit 120
Per-Instance	1000 QPS	Global limit per service instance
Global	5000 QPS	Combined limit across all service instances

When exceeded, HTTP 429 is returned:

{
  "code": 429,
  "message": "Rate limit exceeded",
  "data": {}
}