userFillsByTime

curl --request POST \
  --url 'https://api.uniblock.dev/uni/v1/hyperliquid/info#42' \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "type": "userFillsByTime",
  "startTime": 1704067200000,
  "user": "0x000000000000000000000000000000000000dEaD"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'userFillsByTime',
    startTime: 1704067200000,
    user: '0x000000000000000000000000000000000000dEaD'
  })
};

fetch('https://api.uniblock.dev/uni/v1/hyperliquid/info#42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.uniblock.dev/uni/v1/hyperliquid/info#42"

payload = {
    "type": "userFillsByTime",
    "startTime": 1704067200000,
    "user": "0x000000000000000000000000000000000000dEaD"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

[
  {
    "coin": "@162",
    "px": "1.42",
    "sz": "0.057423",
    "side": "A",
    "time": 1753056000039,
    "startPosition": "0.057423",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 117789741944,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@188",
    "px": "0.0035998",
    "sz": "0.917835",
    "side": "A",
    "time": 1755216000002,
    "startPosition": "0.917835",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 134586652141,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@142",
    "px": "108376.0",
    "sz": "0.000009169",
    "side": "A",
    "time": 1756512000046,
    "startPosition": "0.000009169",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 148186330902,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@142",
    "px": "115538.0",
    "sz": "0.00000008",
    "side": "A",
    "time": 1757635200055,
    "startPosition": "0.00000008",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 159725296618,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@210",
    "px": "0.31764",
    "sz": "0.0405",
    "side": "A",
    "time": 1762732800049,
    "startPosition": "0.0405",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 229209068373,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@156",
    "px": "164.56",
    "sz": "0.000685",
    "side": "A",
    "time": 1762732800049,
    "startPosition": "0.000685",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 229209068363,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@243",
    "px": "0.030574",
    "sz": "0.09241",
    "side": "A",
    "time": 1764028800027,
    "startPosition": "0.09241",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 247895591441,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@230",
    "px": "0.99997",
    "sz": "0.00188948",
    "side": "A",
    "time": 1766102400067,
    "startPosition": "0.00188948",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 273606103340,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@166",
    "px": "0.9997",
    "sz": "0.003306",
    "side": "A",
    "time": 1766188800049,
    "startPosition": "0.003306",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 274644835733,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@206",
    "px": "0.1032",
    "sz": "0.0496",
    "side": "A",
    "time": 1772409600044,
    "startPosition": "0.0496",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 334663993966,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@166",
    "px": "0.99997",
    "sz": "0.00702922",
    "side": "A",
    "time": 1772755200030,
    "startPosition": "0.00702922",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 339777806137,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@305",
    "px": "0.071916",
    "sz": "0.028766",
    "side": "A",
    "time": 1779580800038,
    "startPosition": "0.028766",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 439553311407,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@188",
    "px": "0.0017754",
    "sz": "0.090505",
    "side": "A",
    "time": 1779580800038,
    "startPosition": "0.090505",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 439553311402,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  }
]

POST

hyperliquid

info#42

userFillsByTime

curl --request POST \
  --url 'https://api.uniblock.dev/uni/v1/hyperliquid/info#42' \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "type": "userFillsByTime",
  "startTime": 1704067200000,
  "user": "0x000000000000000000000000000000000000dEaD"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'userFillsByTime',
    startTime: 1704067200000,
    user: '0x000000000000000000000000000000000000dEaD'
  })
};

fetch('https://api.uniblock.dev/uni/v1/hyperliquid/info#42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.uniblock.dev/uni/v1/hyperliquid/info#42"

payload = {
    "type": "userFillsByTime",
    "startTime": 1704067200000,
    "user": "0x000000000000000000000000000000000000dEaD"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

[
  {
    "coin": "@162",
    "px": "1.42",
    "sz": "0.057423",
    "side": "A",
    "time": 1753056000039,
    "startPosition": "0.057423",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 117789741944,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@188",
    "px": "0.0035998",
    "sz": "0.917835",
    "side": "A",
    "time": 1755216000002,
    "startPosition": "0.917835",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 134586652141,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@142",
    "px": "108376.0",
    "sz": "0.000009169",
    "side": "A",
    "time": 1756512000046,
    "startPosition": "0.000009169",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 148186330902,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@142",
    "px": "115538.0",
    "sz": "0.00000008",
    "side": "A",
    "time": 1757635200055,
    "startPosition": "0.00000008",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 159725296618,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@210",
    "px": "0.31764",
    "sz": "0.0405",
    "side": "A",
    "time": 1762732800049,
    "startPosition": "0.0405",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 229209068373,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@156",
    "px": "164.56",
    "sz": "0.000685",
    "side": "A",
    "time": 1762732800049,
    "startPosition": "0.000685",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 229209068363,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@243",
    "px": "0.030574",
    "sz": "0.09241",
    "side": "A",
    "time": 1764028800027,
    "startPosition": "0.09241",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 247895591441,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@230",
    "px": "0.99997",
    "sz": "0.00188948",
    "side": "A",
    "time": 1766102400067,
    "startPosition": "0.00188948",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 273606103340,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@166",
    "px": "0.9997",
    "sz": "0.003306",
    "side": "A",
    "time": 1766188800049,
    "startPosition": "0.003306",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 274644835733,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@206",
    "px": "0.1032",
    "sz": "0.0496",
    "side": "A",
    "time": 1772409600044,
    "startPosition": "0.0496",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 334663993966,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@166",
    "px": "0.99997",
    "sz": "0.00702922",
    "side": "A",
    "time": 1772755200030,
    "startPosition": "0.00702922",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 339777806137,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@305",
    "px": "0.071916",
    "sz": "0.028766",
    "side": "A",
    "time": 1779580800038,
    "startPosition": "0.028766",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 439553311407,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@188",
    "px": "0.0017754",
    "sz": "0.090505",
    "side": "A",
    "time": 1779580800038,
    "startPosition": "0.090505",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 439553311402,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  }
]

Authorizations

X-API-KEY

string

header

required

API key to access the API (Optional)

Query Parameters

chainId

enum<number>

default:999

required

Unique identifier for a blockchain network.

Available options:

999,

998

Example:

999

provider

enum<string>

Specify which provider to use. The project's provider priority list is used by default if no providers are selected. (Priority list can be managed on Uniblock's dashboard)

Available options:

Dwellir,

Chainstack,

Covalent

Body

application/json

type

enum<string>

default:userFillsByTime

required

Available options:

userFillsByTime

Example:

"userFillsByTime"

user

string

required

The account address to query (0x-prefixed).

Example:

"0x000000000000000000000000000000000000dEaD"

startTime

number

required

Inclusive start time, epoch milliseconds.

Example:

1704067200000

endTime

number

Optional exclusive end time, epoch milliseconds. Defaults to now.

Example:

1706745600000

aggregateByTime

boolean

Optional; when true, aggregate fills that occurred at the same time.

Example:

false

reversed

boolean

Optional; when true, return results in reverse (oldest-first) order.

Example:

false

Response

200 - application/json

Successful response.

coin

string

required

Example:

"BTC"

string

required

Example:

"63786.0"

string

required

Example:

"0.028766"

side

string

required

A for ask (sell), B for bid (buy).

Example:

"A"

time

number

required

Example:

1779580800038

startPosition

string

required

Example:

"0.028766"

dir

string

required

Example:

"Spot Dust Conversion"

closedPnl

string

required

Example:

"0.0"

hash

string

required

Example:

"0x0000000000000000000000000000000000000000000000000000000000000000"

oid

number

required

Example:

439553311407

crossed

boolean

required

Example:

true

fee

string

required

Example:

"0.0"

tid

number

required

Example:

0

feeToken

string

required

Example:

"USDC"

twapId

number | null

cloid

string | null

Client order id, or null if the order had none.

builderFee

string

Builder fee charged on this fill, if any.

Example:

"0.0"

liquidation

object | null

Liquidation detail; present only on fills that resulted from a liquidation, otherwise absent.

Show child attributes

Example:

[
  {
    "coin": "@162",
    "px": "1.42",
    "sz": "0.057423",
    "side": "A",
    "time": 1753056000039,
    "startPosition": "0.057423",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 117789741944,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@188",
    "px": "0.0035998",
    "sz": "0.917835",
    "side": "A",
    "time": 1755216000002,
    "startPosition": "0.917835",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 134586652141,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@142",
    "px": "108376.0",
    "sz": "0.000009169",
    "side": "A",
    "time": 1756512000046,
    "startPosition": "0.000009169",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 148186330902,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@142",
    "px": "115538.0",
    "sz": "0.00000008",
    "side": "A",
    "time": 1757635200055,
    "startPosition": "0.00000008",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 159725296618,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@210",
    "px": "0.31764",
    "sz": "0.0405",
    "side": "A",
    "time": 1762732800049,
    "startPosition": "0.0405",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 229209068373,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@156",
    "px": "164.56",
    "sz": "0.000685",
    "side": "A",
    "time": 1762732800049,
    "startPosition": "0.000685",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 229209068363,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@243",
    "px": "0.030574",
    "sz": "0.09241",
    "side": "A",
    "time": 1764028800027,
    "startPosition": "0.09241",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 247895591441,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@230",
    "px": "0.99997",
    "sz": "0.00188948",
    "side": "A",
    "time": 1766102400067,
    "startPosition": "0.00188948",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 273606103340,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@166",
    "px": "0.9997",
    "sz": "0.003306",
    "side": "A",
    "time": 1766188800049,
    "startPosition": "0.003306",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 274644835733,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@206",
    "px": "0.1032",
    "sz": "0.0496",
    "side": "A",
    "time": 1772409600044,
    "startPosition": "0.0496",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 334663993966,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@166",
    "px": "0.99997",
    "sz": "0.00702922",
    "side": "A",
    "time": 1772755200030,
    "startPosition": "0.00702922",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 339777806137,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@305",
    "px": "0.071916",
    "sz": "0.028766",
    "side": "A",
    "time": 1779580800038,
    "startPosition": "0.028766",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 439553311407,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  },
  {
    "coin": "@188",
    "px": "0.0017754",
    "sz": "0.090505",
    "side": "A",
    "time": 1779580800038,
    "startPosition": "0.090505",
    "dir": "Spot Dust Conversion",
    "closedPnl": "0.0",
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "oid": 439553311402,
    "crossed": true,
    "fee": "0.0",
    "tid": 0,
    "feeToken": "USDC"
  }
]

⌘I