Dev tools

Content Out of Date

This content is not maintained and refers to an out-of-date version of Perpetual Protocol.

For the latest documentation, see https://docs.perp.com

Maker bot

An open source maker bot for providing liquidity on Perp v2: https://github.com/perpetual-protocol/perp-maker/

Check out the following resources to get started:

• Blog post (part 1)

• Blog post (part 2)

• Video walkthrough

Arbitrage bot

An open source trading bot for arbitraging between Perp v2 and CEXes like Binance/FTX: https://github.com/perpetual-protocol/perp-curie-arbitrageur

Check out the following resources to get started:

• Blog post

• Video walkthrough

The Graph API

Perpetual Protocol does not provide an official API. Instead it relies on services such as The Graph. This is to ensure the maximum distribution and decentralization possible at this point in the project's development.

The Graph is intended as a data collection, and may not be realtime.

Important Links

• Perp v3 https://thegraph.com/hosted-service/subgraph/perpetual-protocol/perpetual-v2-optimism

  • Schema https://github.com/perpetual-protocol/perp-curie-subgraph
• Uniswap v3 https://thegraph.com/hosted-service/subgraph/ianlapham/optimism-post-regenesis

Definitions

🚧 Definitions will be added as they are requested. Please come to our Discord and request in in the #coding-chat channel!

FundingUpdated

• Updates the global funding params which are used to calculate each trader's funding payment

• Updated per timestamp

FundingPaymentSettled

• Settles a trader's funding payment into owedRealizedPnl

• Calculated before executing openPosition, closePosition, addLiquidity, removeLiquidity.

dailyFundingRate

• Shows funding rate from past 24h

• app.perp.com shows dailyFundingRate / 24 * 100

exchangedPositionNotional

• Shows value of a trade in USD

• Includes non-fee generating swaps, so aggregate fees will be less than 0.1% of this value

Examples

See more examples in the “playground” at The Graph link above.

Query latest Funding Rate

{
  fundingUpdateds(orderBy: blockNumberLogIndex, orderDirection: desc) {
    id
    baseToken
    dailyFundingRate
    timestamp
  }
}

Query your funding payment history

{
  trader(id: "0x9c1e0c67aa30c063f341885b12cb81cc94613fc7") {
    positions(where:{baseToken:"0x8c835dfaa34e2ae61775e80ee29e2c724c6ae2bb"}){
      fundingPayment
      timestamp
    }
  }
}

Query Maker Position Change

{
  liquidityChangeds(
    where:{maker:"0x0000000your0address"},
    orderBy: blockNumberLogIndex, 
    orderDirection: desc
  ) {
    id
    txHash
    maker
    baseToken
    quoteToken
    lowerTick
    upperTick
    base
    quote
    liquidity
    quoteFee
    blockNumber
    timestamp
  }
}

Query Liquidation

{
  positionLiquidateds(
    where:{trader:"0x0000000your0address"}
) {
    txHash
    trader
    baseToken
    liquidator
    liquidationFee
    positionSizeAbs
    positionNotionalAbs
    blockNumber
    timestamp
  }
}

Query prices

{
  positionChangeds(
    orderBy: blockNumberLogIndex,
    orderDirection: desc, 
    where:
      {
        baseToken:"0x8C835DFaA34e2AE61775e80EE29E2c724c6AE2BB"
      }
  )
  {
    swappedPrice
    entryPriceAfter
    marketPriceAfter
    timestamp
  }
}