Tracking Codes

What is a Tracking Code?

Synthetix generates revenue via fees collected through the use of different synthetic assets (e.g. atomic swaps & perps). One such method are maker/taker fees charged on entry/exit of perp positions. Protocols and dapps that wish to partner and/or integrate with Synthetix, can receive a portion of fees relative to volumes generated.

A trackingCode is used to associate and attribute volume generated through atomic and delayed orders.

Obtaining a Tracking Code

Tracking codes are issued on a case by case basis, to genuine integrators once they are actively sending volume through the protocol. There is no documentation or permission required to integrate with Synthetix contracts, so the steps to obtaining a tracking code and share of fees are:

  1. Integrate your project with Synthetix

  2. Set your tracking code as your project name

  3. Perform some transactions on mainnet (for Perps you will see them here)

  4. Reach out in #dev-portal channel on Synthetix Discord, to share your project and early transactions

Volume Attribution

To attribute volume to a tracking code, we provide an amended withTracking method for each market modification call. This allows you to specify a trackingCode as the last argument. If a position is successfully opened a PerpsTracking event is emitted and used for fee revenue attribution.

function modifyPositionWithTracking(
    int sizeDelta,
    uint priceImpactDelta,
    bytes32 trackingCode
) external;

function submitOffchainDelayedOrderWithTracking(
    int sizeDelta,
    uint priceImpactDelta,
    bytes32 trackingCode
) external;

Last updated