Account
GET
Positions
GET
PositionsGET
/v1/account/positions/{address}
Get all statistics related to Moby.
Path Parameters
address*
String
EVM address to check
Query Examples
Response Examples
Properties in the Response
account
String
The account address for which the positions are being retrieved.
BTC
Array
An array of BTC positions.
ETH
Array
An array of ETH positions.
expiry
String
The expiry timestamp of the option in Unix epoch time.
settlePrice
String
The settle price of the option.
positions
Array
An array of position objects for the given cryptocurrency.
underlyingAsset
String
The address of the underlying asset.
optionTokenId
String
The unique identifier for the ERC-1155 option token.
length
String
The number of instrument that the corresponding position held. (naked: 1, combo: 2)
markPrice
Number
The mark price of the position.
markIv
Number
The implied volatility of the mark price.
mainOptionStrikePrice
Number
The strike price of the main option.
pairedOptionStrikePrice
Number
The strike price of the paired option. If the position is naked, it would be 0.
isBuys
String
A string indicating buy/sell status of the each instrument.
strikePrices
String
A string indicating the strike prices of each instrument.
isCalls
String
A string indicating call/put status of the each instrument.
optionNames
String
The names of the instrument.
size
String
The option size of the position.
sizeOpened
String
The size of the position when opened.
sizeClosing
String
The size of the position when closing.
sizeClosed
String
The size of the position when closed.
sizeSettled
String
The size of the position when settled.
isBuy
Boolean
Indicates if the position is a buy.
executionPrice
String
The execution price of the trade. Represented as a string to handle large numbers.
openedToken
String
The paid token contract when the position was opened.
openedAmount
String
The amount of the paid token used when the position was opened.
openedCollateralToken
String
The collateral token contract when the position was opened.
openedCollateralAmount
String
The amount of the collateral token when the position was opened.
openedAvgExecutionPrice
String
The average execution price when the position was opened.
openedAvgSpotPrice
String
The average spot price when the position was opened.
closedToken
String
The closed token contract when the position was closed.
closedAmount
String
The amount of the token used when the position was closed.
closedCollateralToken
String
The collateral token used when the position was closed.
closedCollateralAmount
String
The amount of the collateral token used when the position was closed.
closedAvgExecutionPrice
String
The average execution price when the position was closed.
closedAvgSpotPrice
String
The average spot price when the position was closed.
settledToken
String
The token used when the position was settled.
settledAmount
String
The amount of the token used when the position was settled.
settledCollateralToken
String
The collateral token used when the position was settled.
settledCollateralAmount
String
The amount of the collateral token used when the position was settled.
settledPrice
String
The settle price of the position.
isSettled
Boolean
Indicates if the position is settled.
lastProcessBlockTime
String
The timestamp of the last block when the position was processed, in Unix epoch time.
lastUpdatedAt
String
The timestamp of the last update to the positions data, in Unix epoch time.
GET
Trade History
GET
Trade HistoryGET
/v1/account/optionTradeHistories/{address}
Path Parameters
address*
String
EVM address to check
Query Parameters
period
Integer
Query the last {period} days. If the value is undefined, the default is to query entire history.
Query Examples
Response Examples
Properties in the Response
positionHistories
Object
Contains the list of position histories and related metadata.
positionHistories.nodes
Array
An array of position history objects.
avgExecutionPrice
String
The average execution price of the position. Represented as a string to handle large numbers.
collateralAmount
String
The amount of collateral associated with the position.
collateralToken
String
The address of the collateral token.
expiry
String
The expiry timestamp of the option in Unix epoch time.
processBlockTime
String
The timestamp of the block when the process was executed, in Unix epoch time.
quoteToken
String
The address of the quote token.
quoteAmount
String
The amount of quote token involved in the trade.
requestIndex
String
The index of the request in the system.
roi
String
Return on investment (ROI) of the trade, represented as a string for precision.
cashFlow
String
The cash flow amount associated with the trade.
executionPrice
String
The execution price of the trade. Represented as a string to handle large numbers.
optionTokenId
String
The unique identifier for the ERC-1155 option token.
pnl
String
Profit and loss (P&L) from the trade, represented as a string for precision.
settlePayoff
String
The payoff amount when the option is settled.
settlePrice
String
The price at which the option was settled.
size
String
The size of the option contract
spotPrice
String
The spot price at the time of the trade.
type
String
The type of action, e.g., "close".
totalCount
Integer
The total number of trade until now.
GET
Settlement History
GET
Settlement HistoryGET
/v1/account/optionSettlementHistories/{address}
Path Parameters
address
String
EVM address to check
Query Parameters
period
Integer
Query the last {period} days. If the value is undefined, the default is to query entire history.
Query Examples
Response Examples
Properties in the Response
data
Object
The root object containing the settlement history data.
data.positionHistories
Object
Contains the list of position histories and related metadata.
data.positionHistories.nodes
Array
An array of position history objects.
avgExecutionPrice
String
The average execution price of the position. Represented as a string to handle large numbers.
collateralAmount
String
The amount of collateral associated with the position.
collateralToken
String
The address of the collateral token.
expiry
String
The expiry timestamp of the option in Unix epoch time.
processBlockTime
String
The timestamp of the block when the process was executed, in Unix epoch time.
quoteToken
String
The address of the quote token.
quoteAmount
String
The amount of quote token involved in the trade.
requestIndex
String
The index of the request in the system.
roi
String
Return on investment (ROI) of the trade, represented as a string for precision.
cashFlow
String
The cash flow amount associated with the trade.
executionPrice
String
The execution price of the trade. Represented as a string to handle large numbers.
optionTokenId
String
The unique identifier for the option token.
pnl
String
Profit and loss (P&L) from the trade, represented as a string for precision.
settlePayoff
String
The payoff amount when the option is settled.
settlePrice
String
The price at which the option was settled.
size
String
The size of the position
spotPrice
String
The spot price at the time of the trade
type
String
The type of action, e.g., "open", "close"
totalCount
Integer
The total number of settled position history.
GET
Trade Status
GET
Trade StatusGET
/v1/account/optionTradeStatus/{address}
Path Parameters
address
String
EVM address to check
Query Examples
Response Examples
Properties in the Response
BTC
Object
Contains trade status information for Bitcoin (BTC)
BTC.tradeCount
Integer
The total number of trades executed for BTC
BTC.tradeSize
Number
Sum of all trade executed for BTC
BTC.notionalVolume
Number
The total notional volume (sum of the trade sizes times their prices) for BTC trades
BTC.open
Object
Statistic of overall tradeSize per each type of options for open position
BTC.close
Object
Statistic of overall tradeSize per each type of options for close position
BTC.tradeSizeByTerm
Object
Each tradeSize regarding the type of vault
ETH
Object
Same as BTC
address
String
The EVM address for which the trade status is provided
Last updated