Perpetual Futures

Trade perpetual futures on HyperLiquid through the Suwappu API. Supports 10 markets with up to 20x leverage.

GET /v1/agent/perps/markets

List available perpetual futures markets.

-kw">curl https://api.suwappu.bot/v1/agent/perps/markets \
  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY"

Response:

{
  "hl-key">"success": true,
  "hl-key">"markets": [
    {
      "hl-key">"symbol": "BTC-USD",
      "hl-key">"markPrice": "67234.50",
      "hl-key">"indexPrice": "67230.00",
      "hl-key">"fundingRate": "0.0001",
      "hl-key">"openInterest": "12500000",
      "hl-key">"volume24h": "890000000",
      "hl-key">"maxLeverage": 20
    },
    {
      "hl-key">"symbol": "ETH-USD",
      "hl-key">"markPrice": "3245.80",
      "hl-key">"indexPrice": "3245.20",
      "hl-key">"fundingRate": "0.00008",
      "hl-key">"openInterest": "5600000",
      "hl-key">"volume24h": "340000000",
      "hl-key">"maxLeverage": 20
    }
  ]
}

Available markets: BTC-USD, ETH-USD, SOL-USD, ARB-USD, AVAX-USD, DOGE-USD, MATIC-USD, OP-USD, SUI-USD, APT-USD.

POST /v1/agent/perps/quote

Get a quote for opening a perpetual position.

Parameter	Type	Required	Description
market	string	Yes	Market symbol (e.g., "ETH-USD")
side	string	Yes	"long" or "short"
size	string	Yes	Position size in base asset units
leverage	number	Yes	Leverage multiplier (1-20)

-kw">curl -X POST https://api.suwappu.bot/v1/agent/perps/quote \
  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY" \
  -H -str">"Content-Type: application/json" \
  -d -str">'{
    -str">"market": -str">"ETH-USD",
    -str">"side": -str">"long",
    -str">"size": -str">"0.5",
    -str">"leverage": 10
  }'

Response:

{
  "hl-key">"success": true,
  "hl-key">"quote": {
    "hl-key">"market": "ETH-USD",
    "hl-key">"side": "long",
    "hl-key">"size": "0.5",
    "hl-key">"leverage": 10,
    "hl-key">"entryPrice": "3245.80",
    "hl-key">"liquidationPrice": "2921.22",
    "hl-key">"margin": "162.29",
    "hl-key">"fee": "0.97",
    "hl-key">"fundingRate": "0.00008"
  }
}

GET /v1/agent/perps/positions

List open perpetual positions.

Parameter	Type	Required	Description
address	string	No	Filter by wallet address

-kw">curl https://api.suwappu.bot/v1/agent/perps/positions \
  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY"

Response:

{
  "hl-key">"success": true,
  "hl-key">"positions": [
    {
      "hl-key">"market": "ETH-USD",
      "hl-key">"side": "long",
      "hl-key">"size": "0.5",
      "hl-key">"entryPrice": "3245.80",
      "hl-key">"markPrice": "3302.10",
      "hl-key">"pnl": "28.15",
      "hl-key">"pnlPercent": "17.33",
      "hl-key">"leverage": 10,
      "hl-key">"liquidationPrice": "2921.22",
      "hl-key">"margin": "162.29"
    }
  ]
}