Create a task

: "${MOBIUS_API_BASE_URL:?Set the API URL from your app}"
: "${MOBIUS_API_KEY:?Set your API key locally}"
: "${IDEMPOTENCY_KEY:?Generate and persist an ID before this mutation}"

curl -i "$MOBIUS_API_BASE_URL/v1/delta-neutral/tasks" \
  -H "Authorization: Bearer $MOBIUS_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"longVenue":"hl","shortVenue":"lighter","longMarket":"ETH","shortMarket":"ETH","sizeUsd":100}'

{
  "taskId": "00000000-0000-4000-8000-000000000001",
  "status": "pending"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

POST

delta-neutral

tasks

: "${MOBIUS_API_BASE_URL:?Set the API URL from your app}"
: "${MOBIUS_API_KEY:?Set your API key locally}"
: "${IDEMPOTENCY_KEY:?Generate and persist an ID before this mutation}"

curl -i "$MOBIUS_API_BASE_URL/v1/delta-neutral/tasks" \
  -H "Authorization: Bearer $MOBIUS_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"longVenue":"hl","shortVenue":"lighter","longMarket":"ETH","shortMarket":"ETH","sizeUsd":100}'

{
  "taskId": "00000000-0000-4000-8000-000000000001",
  "status": "pending"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

The example requests $100 per leg: long ETH on Hyperliquid and short ETH on Robinhood Lighter. Both venues need stored, approved bindings. Missing bindings return 409 venue_not_bound with an issues array. Published minimum notional and base quantity are checked before acceptance. The worker checks sizing, venue readiness, and approvals again before trading, so an accepted task can still fail. Do not send order prices, leverage, margin mode, or unknown fields. Configure account settings on the venue first. autoClose: false disables the funding-APY opening and auto-close rule.

This request can place real orders. Confirm the venues, symbols, and per-leg size before running it.

Send a command

Generate and persist the idempotency key once, then run the request. For an uncertain retry, rerun only curl with the same key and body.

export IDEMPOTENCY_KEY="$(uuidgen)"

curl -i "$MOBIUS_API_BASE_URL/v1/delta-neutral/tasks" \
  -H "Authorization: Bearer $MOBIUS_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"longVenue":"hl","shortVenue":"lighter","longMarket":"ETH","shortMarket":"ETH","sizeUsd":100}'

Save the actual taskId from the response. 202 with pending means queued; read the task to check execution.

: "${MOBIUS_API_BASE_URL:?Set the API URL from your app}"
: "${MOBIUS_API_KEY:?Set your API key locally}"
: "${IDEMPOTENCY_KEY:?Generate and persist an ID before this mutation}"

curl -i "$MOBIUS_API_BASE_URL/v1/delta-neutral/tasks" \
  -H "Authorization: Bearer $MOBIUS_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"longVenue":"hl","shortVenue":"lighter","longMarket":"ETH","shortMarket":"ETH","sizeUsd":100}'

Authorizations

Authorization

string

header

required

API key created in this environment: mobius_.. Keep it in a local environment variable; never commit it.

Headers

Idempotency-Key

string

required

Persist one ID per intended mutation before sending. Reuse it with the same request for retries; different content returns 409.

Required string length: 1 - 128

Pattern: ^[!-~]+$

Body

application/json

Use two different, granted and bound venues. Leverage and margin mode are configured on venue accounts, not through this API.

longVenue

enum<string>

required

hl = Hyperliquid; lighter = Lighter RH (Robinhood); lighter-mainnet = canonical Lighter; aster = Aster.

Available options:

hl,

lighter,

lighter-mainnet,

aster

shortVenue

enum<string>

required

hl = Hyperliquid; lighter = Lighter RH (Robinhood); lighter-mainnet = canonical Lighter; aster = Aster.

Available options:

hl,

lighter,

lighter-mainnet,

aster

longMarket

string

required

Exact listed venue symbol. Examples: ETH; Hyperliquid xyz:NVDA or io:ANTH; Aster USD1:XAU or U:BTC. Check current listings.

Examples:

"ETH"

"xyz:NVDA"

"USD1:XAU"

shortMarket

string

required

Exact listed venue symbol. Examples: ETH; Hyperliquid xyz:NVDA or io:ANTH; Aster USD1:XAU or U:BTC. Check current listings.

Examples:

"ETH"

"xyz:NVDA"

"USD1:XAU"

sizeUsd

number

required

USD per leg, within this key’s maximum and venue minimums.

Required range: 10 <= x <= 99999999999999

minFundingApy

number

default:0

Required range: 0 <= x <= 999999

autoClose

boolean

default:true

maxSpreadBps

number

Required range: x <= 99999999999999

liqProtectionPct

number

Required range: x <= 100

sizeMismatchPct

number

Required range: 0.5 <= x <= 100

Response

Command accepted. Inspect task status for execution.

taskId

string<uuid>

required

status

string

required

Allowed value: "pending"

User Guide

Introduction

Protocol

Strategies

API reference

Send a command

Authorizations

Headers

Body

Response

​Send a command

Authorizations

Headers

Body

Response

Send a command