Overview

The Starboard API provides access to Twitter influence rankings, social metrics, and engagement analytics.

Core Queries

Get Starboard Information

query GetStarboard($id: ID!) {
  starboard(id: $id) {
    basicInfo {
      id
      name
      projectName
      description
      tags
      type
      reward {
        name
        description
        startTime
        endTime
      }
    }
  }
}

Get Starboard Leaderboard

query GetStarboardLeaderboard($id: ID!, $first: Int!, $after: String) {
  starboard(id: $id) {
    leaderboard(
      pagination: { 
        forward: { 
          first: $first
          after: $after 
        } 
      }
    ) {
      pageInfo {
        hasNextPage
        endCursor
      }
      edges {
        node {
          xUserProfile {
            username
            followersCount
            verifiedType
          }
          rank {
            value
            delta
            deltaRate
          }
          influenceScore {
            value
            delta
            deltaRate
          }
          change24H { value deltaRate }
          change7D { value deltaRate }
          change30D { value deltaRate }
        }
      }
    }
  }
}

Search Specific User

query SearchUser($id: ID!, $twitterId: String!) {
  starboard(id: $id) {
    leaderboard(
      twitterId: $twitterId
      pagination: { forward: { first: 1 } }
    ) {
      edges {
        node {
          rank { value }
          influenceScore { value deltaRate }
          xUserProfile {
            username
            followersCount
            verifiedType
          }
        }
      }
    }
  }
}

Variables:

{
  "id": "1",
  "twitterId": "elonmusk"
}

Field Reference

Starboard Types

TypeDescription
TWITTERTwitter influence tracking
ONCHAINOn-chain activity tracking

Verification Types

TypeDescription
blueTwitter Blue verification
businessBusiness account verification
governmentGovernment account verification
noneNo verification

StarboardMetricValue Structure

All metrics include comprehensive tracking data:

FieldTypeDescription
valueString!Current metric value
deltaInt!Absolute change from previous period
deltaRateFloat!Percentage change rate
percentageFloat!Relative percentage score

Key Fields

FieldTypeDescription
basicInfoStarboardBasicInfo!Starboard metadata
leaderboardStarboardLeaderboardRankings and metrics
xUserProfileXUserProfileTwitter user information
rankStarboardMetricValueUser’s ranking position
influenceScoreStarboardMetricValueUser’s influence score

Integration Patterns

Basic Leaderboard Query

curl -X POST https://graphigo-business.prd.galaxy.eco/query \
  -H "Content-Type: application/json" \
  -H "access-token: YOUR_ACCESS_TOKEN" \
  -d '{
    "query": "query GetStarboard($id: ID!) { starboard(id: $id) { basicInfo { name type } leaderboard(pagination: { forward: { first: 10 } }) { edges { node { rank { value } xUserProfile { username followersCount } } } } } }",
    "variables": { "id": "1" }
  }'

Pagination Pattern

Starboards use nested pagination structure:

{
  "pagination": {
    "forward": {
      "first": 20,
      "after": "cursor_value"
    }
  }
}

To find a specific Twitter user, use the twitterId parameter with their Twitter username.

Trend Analysis

Use the change metrics to analyze user performance:

  • change24H - 24-hour trends
  • change7D - 7-day trends
  • change30D - 30-day trends

Each includes value (current metric) and deltaRate (percentage change).

Best Practices

  1. Rate Limiting: Limit monitoring requests to once every 5 minutes
  2. Pagination: Use forward pagination for efficient data retrieval
  3. Caching: Cache influence data for 60-300 seconds
  4. Error Handling: Handle cases where users are not tracked
  5. Trend Monitoring: Set alerts for significant score changes (±10%)
  6. User Verification: Check verifiedType for account authenticity

Common Errors

ErrorCauseSolution
Starboard not foundInvalid starboard IDVerify starboard ID exists
Twitter user not foundUser not trackedCheck if user is in starboard
Invalid paginationMalformed pagination inputUse proper PaginationInput structure
Rate limit exceededToo many requestsImplement retry logic

Next Steps