Skip to content

Quickstart (Integrator)

What You Need

  • An RFQ API base URL (provided by the deployer)
  • A JWT bearer token for your organization

Endpoints

Endpoint values can vary by deployment. Always use the values provided by the deployer/operator.

RFQ HTTP API

  • Base URL (production): https://rfq.halfmoondex.com

Addresses

Addresses are environment-specific. Confirm with the deployer/operator.

Production (example)

RFQ Manager:

  • BSC Mainnet: 0x94020Af3571f253754e5566710A89666d90Df615
  • Base Mainnet: 0x7648CE928efa92372E2bb34086421a8a1702bD36

Router:

  • BSC Mainnet: 0xaAeD8af417B4bF80802fD1B0ccd44d8E15ba33Ff
  • Base Mainnet: 0xcd3cA39373A21EDF2d7E68C6596678525447Eb82

Wrapped native token:

  • Ethereum (WETH, chainId 1): 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
  • BSC (WBNB, chainId 56): 0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c
  • Base (WETH, chainId 8453): 0x4200000000000000000000000000000000000006

Typical Flow

  1. Request an indicative quote for UI display.
  2. When the user confirms, request a firm quote.
  3. Use the returned router_address and calldata to submit the on-chain transaction.

Minimal Checklist

  • Use application/json.
  • Use snake_case for request bodies.
  • Send amounts as wei integer strings.
  • Treat native token as the zero address.

Next

  • Authentication: JWT
  • Quote endpoints: Quotes