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

Request an indicative quote for UI display.

2

Request a firm quote

When the user confirms, request a firm quote.

3

Submit on-chain transaction

Use the returned router_address and calldata to submit the on-chain transaction.

circle-info

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