diff --git a/API_REFERENCE.md b/API_REFERENCE.md
index 1e27c07..9f70a53 100644
--- a/API_REFERENCE.md
+++ b/API_REFERENCE.md
@@ -896,13 +896,15 @@ All simulation data is stored in SQLite database at `data/jobs.db`.
 
 - **jobs** - Job metadata and status
 - **job_details** - Per model-day execution details
-- **positions** - Trading position records
-- **holdings** - Portfolio holdings breakdown
-- **reasoning_logs** - AI decision reasoning (if enabled)
+- **trading_days** - Day-centric trading results with daily P&L metrics
+- **holdings** - Portfolio holdings snapshots (ending positions only)
+- **actions** - Trade execution ledger
 - **tool_usage** - MCP tool usage statistics
 - **price_data** - Historical price data cache
 - **price_coverage** - Data availability tracking
 
+See [docs/developer/database-schema.md](docs/developer/database-schema.md) for complete schema reference.
+
 ### Data Retention
 
 - Job data persists indefinitely by default