Skip to main content
POST
/
v1
/
position_margin
Add or reduce position margin
curl --request POST \
  --url https://api.orderly.org/v1/position_margin \
  --header 'Content-Type: application/json' \
  --header 'orderly-account-id: <orderly-account-id>' \
  --header 'orderly-key: <orderly-key>' \
  --header 'orderly-signature: <orderly-signature>' \
  --header 'orderly-timestamp: <orderly-timestamp>' \
  --data '
{
  "symbol": "PERP_ETH_USDC",
  "amount": "3",
  "type": "ADD"
}
'
{
  "success": true,
  "timestamp": 1702989203989
}

Documentation Index

Fetch the complete documentation index at: https://staging-docs.orderly.network/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
orderly-timestamp
string
required

Timestamp of the signed request in milliseconds.

​
orderly-account-id
string
required

Account ID of the authenticated account.

​
orderly-key
string
required

Public orderly key used to sign the request.

​
orderly-signature
string
required

Signature of the request payload generated with the orderly key.

Body

application/json
​
symbol
string
required

Symbol of the isolated position

Example:

"PERP_ETH_USDC"

​
amount
string
required

Amount of margin to add or reduce

Example:

"3"

​
type
enum<string>
required

Operation type

Available options:
ADD,
REDUCE
Example:

"ADD"

Response

200 - application/json

OK

​
success
boolean
required

Indicates whether the request was successful.

Example:

true

​
timestamp
integer

Server timestamp in milliseconds.

Example:

1702989203989