Retrieve merchant ads (limit orders, sweep orders, or market orders) for the authenticated integrator.

Single ad retrieval: Pass uid query parameter to fetch a specific ad by its unique identifier.
When fetching by UID, the ad's stored type is validated against the route's adType path parameter
(unless using the generic rate/rates route which accepts any type).

List retrieval: Omit uid to get a paginated list of all ads for the integrator.
Results can be filtered by side, pair, status, and date range.

Route behavior by adType:

• rate / rates - Generic route. Returns any ad regardless of type. No type mismatch validation.
• limit / limits - Only returns Limit (AD) type ads. Mismatch error for SWEEP/MARKET.
• sweep / sweeps - Only returns SWEEP type ads. Mismatch error for AD/MARKET.
• market / markets - Only returns MARKET type ads. Mismatch error for AD/SWEEP.

Invalid adType values return a 400 validation error.