Portfolio

Portfolio, equity, funding history, and order management. Require Privy JWT authentication.

Get portfolio

get

Returns the user's current portfolio: account value, withdrawable balance, and all open positions with PnL, liquidation distance, funding rate, and cumulative funding earned.

Returns an empty positions array (not an error) if the user has no linked agent wallet or if the database is unavailable.

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Responses

200

Current portfolio state.

application/json

401

Missing or invalid JWT.

application/json

429

Rate limit exceeded.

application/json

500

Internal server error.

application/json

get

/api/portfolio

HTTPcURLJavaScriptPython

GET /api/portfolio HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "accountValue": 52341.67,
  "withdrawable": 2354.12,
  "positions": [
    {
      "coin": "BTC",
      "side": "short",
      "size": 0.5234,
      "notional": 49987.5,
      "entryPrice": 95000,
      "markPrice": 95432.1,
      "liqPrice": 190000,
      "liqDistancePct": 99.1,
      "leverage": 1,
      "unrealizedPnl": -226.4,
      "roe": -0.0045,
      "margin": 49987.5,
      "fundingRate1h": 0.0000123,
      "dailyYield": 14.75,
      "fundingEarned": 342.18
    }
  ]
}

Get equity history

get

Returns the user's equity curve as a series of time/value data points, bucketed by the requested period.

Bucket durations by period:

• 24h: 1-hour buckets

• 1w (default): 1-day buckets

• 1m: 7-day buckets

• all: 30-day buckets

Returns a single current-value point if no historical data is available.

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Query parameters

periodstring · enumOptional

Time period for the equity history.

Default: 1wPossible values:

Responses

200

Equity history data points.

application/json

401

Missing or invalid JWT.

application/json

429

Rate limit exceeded.

application/json

get

/api/portfolio/equity-history

HTTPcURLJavaScriptPython

GET /api/portfolio/equity-history HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "time": 1736553600,
      "value": 52341.67
    }
  ]
}

Get funding payment history

get

Returns the user's funding payment history as bucketed time/value data points. Each point represents net funding received (positive) or paid (negative) in USDC during that bucket.

Same bucket durations as equity-history.

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Query parameters

periodstring · enumOptional

Time period for the funding history.

Default: 1wPossible values:

Responses

200

Funding payment history data points.

application/json

401

Missing or invalid JWT.

application/json

429

Rate limit exceeded.

application/json

get

/api/portfolio/funding-history

HTTPcURLJavaScriptPython

GET /api/portfolio/funding-history HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "time": 1736553600,
      "value": 52341.67
    }
  ]
}

Get trade fill history

get

Returns the user's trade fill history for the requested period. Each record represents one fill with side, size, price, fee, and closed PnL.

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Query parameters

periodstring · enumOptional

Time period for the trade history.

Default: 1wPossible values:

Responses

200

Trade fill history.

application/json

401

Missing or invalid JWT.

application/json

429

Rate limit exceeded.

application/json

get

/api/portfolio/trade-history

HTTPcURLJavaScriptPython

GET /api/portfolio/trade-history HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "time": 1736553600,
      "coin": "BTC",
      "side": "sell",
      "size": 0.5234,
      "price": 95432.1,
      "fee": 2.39,
      "closedPnl": -22.64,
      "dir": "Close Short"
    }
  ]
}

Get open orders

get

Returns all open limit, take-profit, and stop-loss orders for the authenticated user. Orders are fetched directly from Hyperliquid's openOrders info endpoint.

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Responses

200

List of open orders.

application/json

401

Missing or invalid JWT.

application/json

429

Rate limit exceeded.

application/json

502

Internal server error.

application/json

get

/api/orders

HTTPcURLJavaScriptPython

GET /api/orders HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "orders": [
    {
      "oid": 7895634521,
      "coin": "BTC",
      "side": "short",
      "size": 0.5234,
      "origSize": 0.5234,
      "price": 95000,
      "type": "limit",
      "timestamp": 1736553612000
    }
  ]
}

Cancel all open orders

delete

Cancels all open orders for the authenticated user in a single batch request. Returns the count of cancelled orders.

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Responses

200

All orders cancelled.

application/json

401

Missing or invalid JWT.

application/json

429

Rate limit exceeded.

application/json

502

Internal server error.

application/json

delete

/api/orders

HTTPcURLJavaScriptPython

DELETE /api/orders HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "cancelled": 3
}

Cancel a single order

delete

Cancels a single order by order ID. The coin query parameter is required because Hyperliquid's cancel action requires both the order ID and the asset index.

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Path parameters

oidinteger · int64Required

Hyperliquid order ID (integer).

Example: 7895634521

Query parameters

coinstringRequired

Asset symbol for the order (uppercase). Required to resolve the HL asset index.

Example: BTC

Responses

200

Order cancelled.

application/json

400

Invalid request parameters or body.

application/json

401

Missing or invalid JWT.

application/json

429

Rate limit exceeded.

application/json

502

Internal server error.

application/json

delete

/api/orders/{oid}

HTTPcURLJavaScriptPython

DELETE /api/orders/{oid}?coin=BTC HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "cancelled": 7895634521
}