Skip to main content
POST
/
v1
/
info
/
userFillsByTime
Get User Fills By Time
curl --request POST \
  --url https://api.hypereth.io/v1/info/userFillsByTime \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "userFillsByTime",
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
  "startTime": 1681923833000,
  "endTime": 1681924833000
}'
[
  {
    "coin": "BTC",
    "px": "43251.5",
    "sz": "0.25",
    "side": "A",
    "time": 1681923845000,
    "startPosition": "0.0",
    "dir": "Open Long",
    "closedPnl": "125.50",
    "hash": "0x1234567890abcdef...",
    "oid": 127244980388,
    "crossed": true,
    "fee": "0.0001",
    "tid": 98765432
  }
]

Body

application/json
​
type
enum<string>
required

Request type identifier

Available options:
userFillsByTime
​
user
string
required

User's Ethereum address

​
startTime
integer
required

Start time filter in milliseconds

Example:

1681923833000

​
endTime
integer

End time filter in milliseconds

​
aggregateByTime
boolean
default:false

Aggregate fills at same timestamp

​
dex
string
default:""

Perp dex name for multi-dex support

Response

List of user fills within time range

List of user's fills within time range

​
coin
string
required

Trading pair that was executed

Example:

"BTC"

​
px
string
required

Execution price of the fill. String format preserves precision. This is the actual price at which the trade occurred.

Example:

"43251.5"

​
sz
string
required

Size of the fill (amount traded). String format preserves precision. Multiple fills can occur for a single order.

Example:

"0.25"

​
side
enum<string>
required

Side of the fill:

  • "A" = Ask (sell)
  • "B" = Bid (buy)
Available options:
A,
B
​
time
integer
required

Execution timestamp in milliseconds

Example:

1681923845000

​
startPosition
string

Position size before this fill

Example:

"0.0"

​
dir
string

Direction of the fill (Open, Close, etc.)

Example:

"Open Long"

​
closedPnl
string

Realized PnL if position was closed

Example:

"125.50"

​
hash
string

Transaction hash on the blockchain

Example:

"0x1234567890abcdef..."

​
oid
integer

Order ID that generated this fill

Example:

127244980388

​
crossed
boolean

Indicates if the fill crossed the spread (took liquidity). true = market taker, false = market maker

​
fee
string

Trading fee paid for this fill. Negative values indicate rebates. String format preserves precision.

Example:

"0.0001"

​
tid
integer

Trade ID unique to this fill

Example:

98765432