docs: clarify getMarkets example usage

[Olexandr88]

Adds brief documentation comments to the getMarkets example to clarify intent and usage

---

Note

Improves readability of the getMarkets example.

• Adds documentation comments in examples/getMarkets.ts to clarify intent, usage of ClobClient market read-only endpoints, and basic pagination helpers

^{Written by Cursor Bugbot for commit fb40e1f. This will update automatically on new commits. Configure here.}