Skip to content

POST /build/bind

The one-time on-chain referral binding (optional: a first trade through a link also binds).

POST https://marketmayhem.co/api/v1/build/bind
FieldTypeRequiredMeaning
walletstringyesA 0x address
referrerstringyesA 0x address

Every error is { "error": { "code", "message", "fix"? } }. This endpoint can answer:

  • ALREADY_BOUND: The wallet is already bound to a referrer, and a binding is for ever.
  • SELF_REFERRAL: A wallet cannot be its own referrer.
  • REFERRER_NOT_REGISTERED: The referrer is neither a registered referrer nor a creator, so a trade cannot pay it.
  • NOT_DEPLOYED: That feature is not deployed on this network (yet).