Easy Options

Simplified options trading API

Close Easy Option

post

Closes an active Easy Option

Path parameters

idinteger · int64Required

Responses

200

Easy Option close initiated

*/*

404

Easy Option not found

*/*

422

Business validation failed

*/*

post

/v1/easy-options/{id}/close

HTTPcURLJavaScriptPython

POST /api/v1/easy-options/{id}/close HTTP/1.1
Accept: */*

{}

Open Easy Option

post

Opens an Easy Option based on a card and investment amount

Body

application/json

cardIdinteger · int64Required

investmentAmountnumberRequired

Responses

200

Easy Option opened successfully

*/*

400

Invalid input

*/*

422

Business validation failed

*/*

post

/v1/easy-options/open

HTTPcURLJavaScriptPython

POST /api/v1/easy-options/open HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "cardId": 1,
  "investmentAmount": 1
}

{}

Search Easy Options

get

Search easy options with filtering and pagination

Query parameters

Responses

200

Successfully retrieved easy options

*/*

500

Internal server error

get

/v1/easy-options/search

HTTPcURLJavaScriptPython

GET /api/v1/easy-options/search?searchDto=[object+Object] HTTP/1.1
Accept: */*

{
  "content": [
    {
      "id": "text",
      "accountId": 1,
      "cardId": 1,
      "type": "UP_DOWN",
      "status": "PENDING",
      "direction": "UP",
      "investmentAmount": 1,
      "investmentCurrency": "text",
      "targetPrice": 1,
      "triggerPrice": 1,
      "optionSymbol": "text",
      "positionId": "text",
      "orderId": "text",
      "qty": 1,
      "entryPrice": 1,
      "openTime": 1,
      "closeTime": 1,
      "triggerTime": 1,
      "cardName": "text",
      "fee": 0.5,
      "closePrice": 51000,
      "pl": 100,
      "plClosed": 100
    }
  ],
  "page": 1,
  "size": 1,
  "totalElements": 1,
  "totalPages": 1,
  "empty": true,
  "numberOfElements": 1
}

get

Query parameters

Responses

200

OK

*/*

get

/v1/easy-options/list

HTTPcURLJavaScriptPython

GET /api/v1/easy-options/list?searchDto=[object+Object] HTTP/1.1
Accept: */*

200

OK

[
  {
    "id": 1,
    "type": "CALL",
    "underlying": "BTCUSDT",
    "direction": "BULLISH",
    "targetPrice": 50000,
    "triggerPrice": 49000,
    "optionSymbol": "BTC-250418-50000-C",
    "expiryDate": "2026-04-18T11:18",
    "tradingIdea": "BTC is expected to rally after halving",
    "autoGenerated": false,
    "active": true,
    "title": "BTC Bull Run",
    "description": "Bitcoin expected to break resistance at 50k",
    "currentAskPrice": 1200.5,
    "currentOptionSymbol": "BTC-250418-50000-C"
  }
]