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

*/*

objectOptional

404

Easy Option not found

*/*

422

Business validation failed

*/*

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

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

cardIdinteger · int64Required

investmentAmountnumberRequired

Responses

200

Easy Option opened successfully

*/*

objectOptional

400

Invalid input

*/*

422

Business validation failed

*/*

post/v1/easy-options/open

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

*/*

pageinteger · int32Optional

sizeinteger · int32Optional

totalElementsinteger · int64Optional

totalPagesinteger · int32Optional

emptybooleanOptional

numberOfElementsinteger · int32Optional

500

Internal server error

get/v1/easy-options/search

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

*/*

Easy Option Card data transfer object

idinteger · int64Optional

Card unique identifier

Example: 1

typestring · enumRequired

Option type

Example: CALLPossible values:

underlyingstring · min: 3 · max: 2147483647Required

Underlying asset symbol

Example: BTCUSDT

directionstring · enumRequired

Trade direction

Example: BULLISHPossible values:

targetPricenumberRequired

Target price for the option

Example: 50000

triggerPricenumberOptional

Trigger price for the option

Example: 49000

optionSymbolstringOptional

Option symbol

Example: BTC-250418-50000-C

expiryDatestring · date-timeRequired

Expiry date in ISO 8601 format

Example: 2026-04-18T11:18

tradingIdeastring · max: 255Optional

Trading idea or rationale

Example: BTC is expected to rally after halving

autoGeneratedbooleanOptional

Whether the card was auto-generated

Example: false

activebooleanOptional

Whether the card is active

Example: true

titlestring · max: 100Required

Card title

Example: BTC Bull Run

descriptionstring · max: 255Optional

Card description

Example: Bitcoin expected to break resistance at 50k

currentAskPricenumberOptional

Current ask price for the option

Example: 1200.5

currentOptionSymbolstringOptional

Current option symbol being traded

Example: BTC-250418-50000-C

get/v1/easy-options/list

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"
  }
]