Skip to main content
POST
/
monitor
/
{reportId}
curl -X POST http://localhost:3001/monitor/a1b2c3d4 \
  -H "Content-Type: application/json" \
  -d '{"intervalMs": 60000}'

{
  "success": true,
  "data": {
    "reportId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "githubUrl": "https://github.com/ripple/rippled",
    "intervalMs": 60000,
    "message": "Monitoring started"
  }
}

​
Path Parameters

​
reportId
string
required
Report ID of the analyzed repo to monitor.

​
Request Body

​
intervalMs
number
default:"30000"
Monitoring interval in milliseconds. Minimum: 10,000 (10 seconds).

​
Response

​
data
object
curl -X POST http://localhost:3001/monitor/a1b2c3d4 \
  -H "Content-Type: application/json" \
  -d '{"intervalMs": 60000}'

{
  "success": true,
  "data": {
    "reportId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "githubUrl": "https://github.com/ripple/rippled",
    "intervalMs": 60000,
    "message": "Monitoring started"
  }
}

​
What Gets Monitored

The agent checks for changes on each interval:
  • New commits — Detected via latest commit SHA comparison
  • Star changes — Triggers if stars change by >5% (minimum 10 star difference)
  • Contributor changes — New contributors joining the project
When changes are detected, the agent:
  1. Re-scrapes the repo
  2. Re-runs AI analysis
  3. Updates scores
  4. Auto-adjusts market positions if scores shift
  5. Triggers XRPL hooks on significant score drops (>15 points)