Perpetual Protocol

🛠 Connector Info¶

Exchange Type: Decentralized Exchange (DEX)
Market Type: Central Limit Order Book (CLOB)

Component	Status	Notes
🔀 Spot Connector	Not available
🔀 Perp Connector	✅
🕯 AMM Data Feed	✅

ℹ️ Exchange Info¶

Website: https://perp.com/
CoinMarketCap: https://coinmarketcap.com/exchanges/perpetual-protocol/
CoinGecko: https://www.coingecko.com/en/exchanges/perpetual_protocol
API Docs: https://perp.com/developers
Fees:

🔑 How to Connect¶

Create a wallet on one of the supported networks below:

Chain	Networks
`ethereum`	`optimism`

From inside the Hummingbot client, run gateway connect perpetual_protocol in order to connect your wallet:

Which chain do you want perp to connect to? (ethereum) >>>
Which network do you want perp to connect to? (optimism) >>>
Enter your ethereum-optimism private key >>>>

If connection is successful:

The perp connector now uses wallet [pubKey] on ethereum-optimism

🔀 Spot Connector¶

Integration to spot markets API endpoints

ID: perpetualprotocol
Connection Type: REST via Gateway
API Docs: https://docs.perpetualprotocol-test.com/api
Folder: https://github.com/hummingbot/gateway/tree/main/src/connectors/perp
Default Configs: https://github.com/hummingbot/gateway/blob/main/src/templates/perp.yml

Endpoints¶

/amm/perp/market-prices
/amm/perp/market-status
/amm/perp/pairs
/amm/perp/position
/amm/perp/balance
/amm/perp/open
/amm/perp/close

For more info, run Gateway and go to in your browser to see detailed documentation for each endpoint.

🕯 AMM Data Feed¶

Data feed of this exchange's real-time prices

ID: perpetualprotocol_[CHAIN]_[NETWORK]
Connection Type: REST via Gateway
Folder: https://github.com/hummingbot/hummingbot/blob/master/hummingbot/data_feed/amm_gateway_data_feed.py

Usage¶

from hummingbot.data_feed.amm_gateway_data_feed import AmmGatewayDataFeed
prices = AmmGatewayDataFeed(
        connector_chain_network="perp_ethereum_optimism",
        trading_pairs={"WAVAX-USDC", "PERP-USDC"},
        order_amount_in_base=Decimal("1"),
    )