Statistics

GET /stats

Get launch statistics overview.

Request

Request

GET /stats

Response

Response (example)

{
  "overview": {
    "total": 1542,
    "launched": 1538,
    "pending": 3,
    "failed": 1,
    "totalLaunches": 1538,
    "totalFailed": 15,
    "lastPollAt": "2024-01-15T12:00:00.000Z"
  },
  "timestamp": "2024-01-15T12:00:30.000Z"
}

Response Fields

Field	Type	Description
total	number	Total followers tracked
launched	number	Currently in launched status
pending	number	Currently pending
failed	number	Currently failed
totalLaunches	number	All-time successful launches
totalFailed	number	All-time failures (includes retried)
lastPollAt	string	Last scanner poll time

Example

Example

curl http://localhost:3000/stats | jq

---

GET /logs

View audit logs with optional filtering.

Request

Request (example)

GET /logs?limit=50&action=LAUNCH_SUCCESS

Query Parameters

Parameter	Type	Default	Description
limit	number	50	Results (max 100)
action	string	-	Filter by action type

Action Types

Action	Description
DETECTED	New follower found
LAUNCH_STARTED	Processing began
IPFS_UPLOADED	Metadata uploaded
TX_SUBMITTED	Transaction sent
LAUNCH_SUCCESS	Launch completed
LAUNCH_FAILED	Launch failed
RETRY_SCHEDULED	Retry initiated

Response

Response (example)

{
  "logs": [
    {
      "id": "log-456",
      "followerId": "abc-123-def",
      "action": "LAUNCH_SUCCESS",
      "details": {
        "tokenAddress": "7xKXtg...",
        "signature": "5Uj8...",
        "pumpUrl": "https://pump.fun/7xKXtg..."
      },
      "createdAt": "2024-01-15T12:00:00.000Z",
      "follower": {
        "username": "cryptofan"
      }
    }
  ]
}

Response Fields

Field	Type	Description
id	string	Log entry ID
followerId	string	Associated follower
action	string	Action type
details	object?	Action-specific details
createdAt	string	Timestamp
follower.username	string	Follower username

Examples

Get All Recent Logs

curl "http://localhost:3000/logs?limit=20"

Get Only Successes

curl "http://localhost:3000/logs?action=LAUNCH_SUCCESS"

Get Only Failures

curl "http://localhost:3000/logs?action=LAUNCH_FAILED"

Get Detection Events

curl "http://localhost:3000/logs?action=DETECTED"

---

Analytics Queries

Success Rate

Calculate Success Rate

# Get stats
stats=$(curl -s http://localhost:3000/stats)

# Calculate rate
total=$(echo $stats | jq '.overview.totalLaunches + .overview.totalFailed')
success=$(echo $stats | jq '.overview.totalLaunches')
rate=$(echo "scale=2; $success / $total * 100" | bc)

echo "Success rate: $rate%"

Recent Activity

Last 10 Launches

# Last 10 launches
curl -s "http://localhost:3000/logs?action=LAUNCH_SUCCESS&limit=10" | \
  jq '.logs[] | {username: .follower.username, time: .createdAt}'

Failed Launch Details

Failure Details

# Get failure details
curl -s "http://localhost:3000/logs?action=LAUNCH_FAILED&limit=10" | \
  jq '.logs[] | {username: .follower.username, error: .details.error}'

---

Monitoring Dashboard Data

For Grafana / Custom Dashboard

metrics.sh

#!/bin/bash

# metrics.sh - Output metrics for monitoring

stats=$(curl -s http://localhost:3000/stats)

echo "wallet_protect_followers_total $(echo $stats | jq '.overview.total')"
echo "wallet_protect_launched_total $(echo $stats | jq '.overview.launched')"
echo "wallet_protect_pending_count $(echo $stats | jq '.overview.pending')"
echo "wallet_protect_failed_count $(echo $stats | jq '.overview.failed')"
echo "wallet_protect_success_rate $(echo $stats | jq '(.overview.totalLaunches / (.overview.totalLaunches + .overview.totalFailed)) * 100')"

Cron Job for Logging

/etc/cron.d/wallet-protect-stats

*/5 * * * * root curl -s http://localhost:3000/stats >> /var/log/wallet-protect-stats.json