Settle PnL

Any realized and unrealized PnL accrued from open or closed positions needs to be “settled” into the USDC balance of the account. PnL settlement can be triggered at any time — either by other users or by the account owner. To trigger PnL settlement for your own account:

Get a Settle PnL nonce

Get a nonce from Get Settle PnL Nonce.

Obtain signature from EIP-712

Sign an EIP-712 message in the following format:

{
  "brokerId": "woofi_dex",
  "chainId": 80001,
  "settleNonce": 1,
  "timestamp": 1685973017064
}

where:

Name	Type	Required	Description
brokerId	string	Y	The unique identifier of the Builder (also known as Broker ID).
chainId	int	Y	Chain ID of the connected chain where the message was signed
settleNonce	int	Y	Valid settlement nonce from Get Settle PnL Nonce
timestamp	timestamp	Y	Current timestamp in UNIX milliseconds

Request PnL settlement

Submit the request through Request PnL Settlement API.

Example

The example code is very similar to the Orderly Key registration, except it uses the EIP-712 on-chain domain and the signed message is different.

Exclusive Receiver Address Order Management

Builder quickstart

Partner onboarding & support

Core integration flows

Builders Marketplace

API fundamentals

Public Info API

General API

User API

Trading API

Strategy vault API

Staking & VALOR API

Builder API

Points module

Market data API

Websocket API

Example

​Example

Example