API Reference
Track Accounts

Track Accounts

Manage which X accounts you're monitoring for follow activity.


Add Account

POST /v1/track

Cost: $0.10

Starts monitoring an X account for new follows.

curl -X POST https://frontrun.vc/v1/track \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"username": "pmarca"}'

Request body

FieldTypeRequiredDescription
usernamestringYesX username to track. Leading @ is stripped automatically.

Response

{
  "username": "pmarca",
  "tracking": true,
  "follow_count": 70,
  "cost_cents": 10,
  "balance_cents": 4990,
  "message": "Tracking active. New follows will appear once activity is detected."
}
FieldTypeDescription
follow_countintegerNumber of accounts currently being followed.

Errors

StatusDescription
402Insufficient balance
404X account not found
409Already tracking this account

Remove Account

DELETE /v1/track/:username

Cost: Free

Stops monitoring an account.

curl -X DELETE https://frontrun.vc/v1/track/pmarca \
  -H "X-API-Key: your_api_key"

Response

{
  "username": "pmarca",
  "tracking": false
}

List Tracked Accounts

GET /v1/track

Cost: Free

Returns all accounts you're currently monitoring.

curl https://frontrun.vc/v1/track \
  -H "X-API-Key: your_api_key"

Response

{
  "count": 3,
  "accounts": [
    {
      "username": "pmarca",
      "created_at": "2026-03-01T12:00:00Z"
    },
    {
      "username": "naval",
      "created_at": "2026-03-01T12:01:00Z"
    },
    {
      "username": "paulg",
      "created_at": "2026-03-07T18:30:00Z"
    }
  ]
}