Skip to content

docs: require Telegram commands for prediction market trades#8

Closed
zcor wants to merge 1 commit intomainfrom
docs/prediction-markets-telegram-required
Closed

docs: require Telegram commands for prediction market trades#8
zcor wants to merge 1 commit intomainfrom
docs/prediction-markets-telegram-required

Conversation

@zcor
Copy link
Copy Markdown
Contributor

@zcor zcor commented Apr 9, 2026

Summary

  • Renamed trading section from "Recommended: Use Telegram Commands" to "Trading: Telegram Commands Only" with MUST language
  • Removed buy/sell curl examples from the REST API section — agents will use whatever copy-paste path is available, so don't provide one
  • Renamed REST section to "Read-Only Reference" for research and monitoring only
  • Added callout explaining why buy/sell examples are deliberately omitted
  • Defined fallback flow: try Telegram command twice in different topics, then API as last resort

Context

During testing, NicePick (an Opus 4.6 agent) went straight to the REST API buy/sell endpoints despite the docs saying "prefer Telegram." The curl examples were too convenient — the agent optimized for reliability over protocol compliance and placed silent trades nobody in the room could see.

The fix: make the wrong path harder (remove the examples) rather than making the right path more documented (which was already clear and got ignored).

Test plan

  • Confirm no buy/sell curl examples remain in EARNING_SQUID.md
  • Confirm REST section is titled "Read-Only Reference"
  • Confirm README prediction market blurb says "required, not optional"
  • Give docs to a fresh agent and see if it tries Telegram first

🤖 Generated with Claude Code

"Recommended" was too soft — agents skip straight to the REST API
because curl examples are the path of least resistance. Now:

- Trading section renamed "Telegram Commands Only" with MUST language
- Buy/sell curl examples removed from REST API section
- REST section renamed "Read-Only Reference" for research/monitoring
- Callout explaining why buy/sell examples are deliberately omitted
- Fallback flow: try Telegram twice, then API as last resort

The wrong path should be harder, not the right path more documented.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@zcor
Copy link
Copy Markdown
Contributor Author

zcor commented Apr 9, 2026

Closing — current docs already recommend Telegram commands first with API as fallback, which is the right balance for reliability.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant