Fix limit order API examples and documentation

[LawrenceMarsman]

Summary

Fixes critical inaccuracies in limit order API examples and documentation across all languages (Go, Python, Java).

Changes

API Example Corrections

All Languages (Go, Python, Java):

• Fixed resource name format: limit_orders/{id} (not nested under groups/accounts)
• Added required owner field to CreateLimitOrder
• Removed invalid pagination fields from ListLimitOrders and SearchLimitOrders
  • No page_size, page_token, or next_page_token (these don't exist in protobuf)
• Fixed SearchLimitOrders filters to only use: token, account, live_ledger_data
• Fixed MonitorLimitOrder to use oneof identifier (name OR external_reference)
• Corrected CancelLimitOrder return type (returns LimitOrder, not response wrapper)
• Fixed status enums: LIMIT_ORDER_STATUS_COMPLETE (not FILLED or PARTIALLY_FILLED)

Go-specific:

• Added missing type_v1 import to create example

Enhanced Monitoring Patterns

monitor-limit-order examples:

• Handle all 7 limit order states with proper transitions
• Use labeled breaks (monitorOrder:) for clean exit
• Show transient states: SUBMISSION_IN_PROGRESS, COMPLETE_IN_PROGRESS, CANCELLATION_IN_PROGRESS

create-limit-order examples:

• Monitor order after creation until it reaches OPEN status
• Handle SUBMISSION_FAILED with error
• Show complete workflow from creation to active order

cancel-limit-order examples:

• Monitor order after cancellation until it reaches CANCELLED status
• Track CANCELLATION_IN_PROGRESS → CANCELLED transition
• Confirm completion on ledger

Documentation Fixes (index.mdx)

• Corrected resource naming section (flat format, not nested hierarchy)
• Fixed all status enum references throughout
• Removed incorrect pagination documentation
• Clarified MonitorLimitOrder uses oneof (not multiple filters)
• Added comprehensive list of all 7 order states
• Updated create workflow to include required owner field and monitoring

Verification

All changes verified against protobuf definitions:

• proto/meshtrade/trading/limit_order/v1/service.proto
• proto/meshtrade/trading/limit_order/v1/limit_order.proto

Test Plan

• Reviewed all 21 example files (7 endpoints × 3 languages)
• Verified field names against protobuf definitions
• Confirmed status enum values match LimitOrderStatus enum
• Validated resource name formats
• Checked monitoring patterns follow production examples

Files Modified

• 19 files: 348 insertions, 175 deletions
• 6 example endpoints × 3 languages = 18 example files
• 1 service documentation file (index.mdx)

🤖 Generated with Claude Code