userFillsByTime

userFillsByTime

post

Body

Request envelope for the /exchange endpoint.

All exchange requests must include:

• action: The action to perform
• signature: EIP-712 signature authorizing the action
• nonce: Unix timestamp in milliseconds (must be within validity window)

expiresAfterinteger · nullableOptional

Optional expiry for L1-signed actions.

nonceinteger · int64Required

Request nonce (Unix timestamp in milliseconds)

vaultAddressstring · nullableOptional

Optional vault address for vault operations

Responses

200

Request successful. Response format depends on the requested action.

application/json

or

400

Request body was not valid JSON

text/plain

422

JSON body did not match a supported exchange schema

text/plain

500

Internal server error

application/json

post/exchange

POST /exchange HTTP/1.1
Host: api.hyperlink.xyz
Content-Type: application/json
Accept: */*
Content-Length: 181

{
  "action": {
    "aggregateByTime": null,
    "endTime": null,
    "startTime": 1,
    "type": "userFillsByTime"
  },
  "expiresAfter": null,
  "nonce": 1,
  "signature": {
    "r": "text",
    "s": "text",
    "v": 1
  },
  "vaultAddress": null
}

[
  {
    "coin": "ETH",
    "px": "2500.0",
    "sz": "1.0",
    "side": "B",
    "time": 1789329600000,
    "startPosition": "0.0",
    "dir": "Open Long",
    "closedPnl": "0.0",
    "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
    "oid": 123456,
    "crossed": true,
    "fee": "1.5",
    "tid": 987654,
    "feeToken": "USDC",
    "builderFee": "0.25",
    "cloid": "0x1234567890abcdef1234567890abcdef",
    "liquidation": null
  }
]