Unified REST APIStrategy

Get Strategy Status

Get the current status and details of a submitted maker-taker arbitrage strategy.

Status Lifecycle:

  • pending → Strategy submitted, not yet started
  • maker_placing → Placing maker order
  • waiting_trigger → Maker order placed, waiting for trigger conditions
  • taker_triggered → Taker order being executed
  • reconciling → Checking for position discrepancies
  • completed → Strategy completed successfully
  • completed_with_recovery → Completed with position recovery
  • failed → Strategy failed (see error field)
  • cancelled → Strategy was cancelled
  • timed_out → Strategy timed out
  • requires_intervention → Manual intervention required

Endpoint: GET https://api.hypereth.io/v2/all/strategy/status/maker-taker-arbitrage/{strategyId}

GET
/strategy/status/maker-taker-arbitrage/{strategyId}

Authorization

ApiKeyAuth
X-API-KEY<token>

In: header

Path Parameters

strategyId*stringrequired

The strategy ID returned from submit endpoint

Response Body

application/json

curl -X GET "https://api.hypereth.io/v2/all/strategy/status/maker-taker-arbitrage/maker_taker_550e8400-e29b-41d4-a716-446655440000"
{
  "strategyId": "maker_taker_550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "createdAt": 1710000000000,
  "updatedAt": 1710000005000,
  "stateHistory": [
    "Pending",
    "PlacingMaker",
    "WaitingTrigger",
    "PlacingTaker",
    "Completed"
  ],
  "makerLeg": {
    "orderId": "12345",
    "status": "closed",
    "filledSize": "100",
    "remainingSize": "0",
    "avgFillPrice": "0.01",
    "placeTxHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "cancelTxHash": null,
    "recovery": null
  },
  "takerLeg": {
    "orderId": "67890",
    "status": "closed",
    "filledSize": "100",
    "remainingSize": "0",
    "avgFillPrice": "0.0099",
    "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
    "recovery": null
  },
  "request": {
    "symbol": "MON",
    "marketType": "spot",
    "references": "MON/AUSD",
    "amount": "100",
    "maker": {
      "exchange": "kuru",
      "accountId": "acc_A",
      "side": "buy",
      "price": "0.01"
    },
    "taker": {
      "exchange": "kuru",
      "accountId": "acc_B",
      "side": "sell"
    }
  }
}
Empty
Empty

Submit Maker-Taker Arbitrage Strategy POST

Submit a maker-taker arbitrage strategy that places a maker order on one exchange and triggers a taker order on another exchange when conditions are met. **How it works**: 1. Places a maker (limit) order on the maker exchange with GTX (post-only) 2. When the maker order is placed, monitors for trigger conditions 3. When triggered, executes a taker order on the taker exchange 4. Optionally reconciles positions if there's a discrepancy **Use Cases**: - Cross-exchange arbitrage - Market making with hedging - Spread capture strategies **Endpoint**: `POST https://api.hypereth.io/v2/all/strategy/submit/maker-taker-arbitrage`

List Maker-Taker Arbitrage Strategies GET

List all maker-taker arbitrage strategies for the authenticated user. Returns strategies sorted by creation time (newest first). **Endpoint**: `GET https://api.hypereth.io/v2/all/strategy/list/maker-taker-arbitrage`