Skip to content

Conversation

@derrekcoleman
Copy link
Contributor

@derrekcoleman derrekcoleman commented Dec 3, 2025

Summary

Adds comprehensive documentation for Aerodrome spot trading competitions, including competition mechanics, scoring rules, and developer resources for building trading agents.

Changes

  • New spot trading guide (docs/competitions/spot-guide.mdx): Complete guide covering Aerodrome DEX basics, competition rules, ROI-based scoring, and comparison with other competition types
  • Developer resources section: Links to MCP server, QuickNode/Bitquery guides, and smart contract references
  • API documentation updates: Synced OpenAPI specs and regenerated endpoint documentation for agents, arenas, leaderboard, and trading endpoints
  • Navigation update: Added spot guide to competitions section in docs/meta.json

The dotenv config fix in the sync-openapi script is also included.Also includes a dotenv config fix for the openapi sync script.

Screenshot 2025-12-03 at 1 52 59 PM

@vercel
Copy link
Contributor

vercel bot commented Dec 3, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Dec 9, 2025 1:16am

Copy link
Contributor

@mzkrasner mzkrasner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! approving for now, but some small things you might want to include before you merge:

1. Add spot live trading to "Live skill markets" table

File: docs/get-started/skill-markets.mdx (around line 79)

The table lists 10 markets but is missing spot live trading. Add a row:

| [Live Trading - Spot (Aerodrome)](https://app.recall.network/leaderboards/spot_live_trading) | Live onchain spot trading competition on Aerodrome DEX (Base) |

(this is not available yet on prod but will be once the release is cut)

2. Add spot guide link to callout

File: docs/get-started/skill-markets.mdx (lines 16-18)

Current:

<Callout type="info">
  Ready to compete? Check out the [paper trading](/competitions/paper-trading) and [perpetual
  futures](/competitions/perps-guide) competition guides to get started.
</Callout>

Should be:

<Callout type="info">
  Ready to compete? Check out the [paper trading](/competitions/paper-trading), [spot trading](/competitions/spot-guide), and [perpetual futures](/competitions/perps-guide) competition guides to get started.
</Callout>

Note: Leaderboard enum fixed in js-recall

The /api/leaderboard endpoint's type parameter was missing spot_live_trading and sports_prediction in the OpenAPI JSDoc. This was a js-recall documentation bug that has been fixed in 1635. The recall-docs PR will need to re-sync the OpenAPI spec after this fix is merged.

derrekcoleman and others added 4 commits December 8, 2025 18:13
The sync-openapi script was failing with "OPENAPI_SOURCE_URL environment
variable is required" even though the variable existed in .env. Added
dotenv/config import to load environment variables before the script
accesses process.env.
Add spot trading guide link to callout and spot live trading row to markets table per PR review feedback.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Re-sync OpenAPI spec to include spot_live_trading and sports_prediction enum values from js-recall PR 1635.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@derrekcoleman derrekcoleman force-pushed the derrek/add-aerodrome-spot branch from ea227dd to 4d360fe Compare December 9, 2025 01:13
@derrekcoleman derrekcoleman merged commit e47b90d into main Dec 9, 2025
5 checks passed
@derrekcoleman derrekcoleman deleted the derrek/add-aerodrome-spot branch December 9, 2025 01:17
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.

3 participants