Aggregator Partner Program

Overview

The HX.finance Partner Program allows aggregators and DEX interfaces to provide their users with bonus HXP (HX Points) when trading or providing liquidity through their platforms. Users earn points automatically through our tracking system, with additional multipliers when using partner codes.

Key Benefits for Aggregators

How It Works

This means:

• ✅ Users get points when trading through your router
• ✅ No special integration needed
• ✅ Points are automatically attributed correctly
• ✅ Works with any aggregator or DEX interface

Partnership Setup

Step 1: Request Your Partner Code

Contact the HX.finance team to receive your unique partner code:

• Discord: discord.hx.finance (opens in a new tab)
• Email: partners@hx.finance

We'll configure:

• Your partner name (e.g., "1inch", "OpenOcean", "Matcha")
• Point multiplier (typically 2x)
• Bonus duration (30 days, permanent, or custom)

Step 2: Share With Your Users

Share your partner link with users: https://app.hx.finance?partner=YOUR_CODE

Users click the link once to activate, then trade anywhere to earn bonus points!

Step 3: Users Trade & Earn

Once activated, users earn multiplied points on ALL activities:

• Trading through your aggregator UI
• Direct DEX trades
• Liquidity provision (LP positions)
• Other interfaces
• All count with your multiplier!

User Activation Flow

For Your Users

1. One-Time Activation

   • Visit your partner link: https://app.hx.finance?partner=YOUR_PARTNER_CODE
   • The code will be automatically activated

2. Trade or Provide Liquidity Anywhere

   • Use your aggregator's UI
   • Use HX.finance native interface
   • Use any other DEX
   • Provide liquidity to pools
   • All activities earn bonus points!

3. Earn Multiplied Points

   • Trading Base: 0.01 HXP per $1 traded
   • Trading with 2x code: 0.02 HXP per $1 traded
   • LP Base: 0.24 HXP per $1 per day
   • LP with 2x code: 0.48 HXP per $1 per day
   • Minimum trade: $10

API Integration

Query user points from our subgraph:

const SUBGRAPH_URL = 
  'https://api.goldsky.com/api/public/project_cmay1j7dh90w601r2hjv26a5b/subgraphs/hx-points/2.3.3/gn';
 
async function getUserPoints(userAddress) {
  const query = `
    {
      user(id: "${userAddress.toLowerCase()}") {
        tradingPoints
        totalPointsEarned
        activePartnershipCode
      }
    }
  `;
  
  const response = await fetch(SUBGRAPH_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ query })
  });
  
  return response.json();
}

Points Calculation

Base Points System

With 2x Partner Multiplier

Verification Tools

Check User Points Script

Download our verification tool:

# Download the script
curl -O https://raw.githubusercontent.com/hxfinance/hx-docs/main/scripts/check-user-points.js
 
# Check any user's points
node check-user-points.js

Live Subgraph Endpoint

https://api.goldsky.com/api/public/project_cmay1j7dh90w601r2hjv26a5b/subgraphs/hx-points/2.3.3/gn

Frequently Asked Questions

Technical Details

Smart Contract Addresses

Subgraph Schema

type User {
  id: ID!  # User wallet address
  tradingPoints: BigDecimal!
  liquidityPoints: BigDecimal!
  totalPointsEarned: BigDecimal!
  activePartnershipCode: String
}
 
type PartnershipCode {
  id: ID!  # Code string
  partner: String!
  multiplier: BigDecimal!
  isActive: Boolean!
  usageCount: BigInt!
}

Getting Started

1. Contact Team - Reach out via Discord, or email
2. Get Your Code - Receive custom partner code with multiplier
3. Share With Users - Add to docs, UI, and announcements
4. Track Success - Monitor adoption via subgraph queries

Support

For technical integration support:

• Discord: discord.hx.finance (opens in a new tab)
• Documentation: docs.hx.finance (opens in a new tab)