Skip to main content
GET
/
api
/
v1
/
bulk_order_fills
Get bulk order fills
curl --request GET \
  --url https://api.mainnet.aptoslabs.com/decibel/api/v1/bulk_order_fills \
  --header 'Authorization: Bearer <token>'
[
  {
    "event_uid": 1,
    "filled_size": 123,
    "is_bid": true,
    "market": "0xmarket123...",
    "price": 123,
    "sequence_number": 12345,
    "trade_id": "3647276",
    "transaction_unix_ms": 1730841600000,
    "transaction_version": 12345,
    "user": "0x123..."
  }
]

Authorizations

​
Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

​
account
string
required

User account address (user query alias is also accepted)

​
market
string

Filter by specific market address. Use all to disable market filtering.

​
sequence_number
integer<int64>

Single sequence number to query. Mutually exclusive with start_sequence_number/end_sequence_number.

Required range: x >= 0
​
start_sequence_number
integer<int64>

Start of sequence number range. Mutually exclusive with sequence_number.

Required range: x >= 0
​
end_sequence_number
integer<int64>

End of sequence number range. Requires start_sequence_number when provided.

Required range: x >= 0
​
limit
integer<int32>
default:10

Effective page size (clamped to 1..=1000 at runtime)

Required range: 1 <= x <= 1000
​
offset
integer<int32>
default:0

Page offset

Required range: 0 <= x <= 10000

Response

Bulk order fills retrieved successfully

​
event_uid
integer
required
Required range: x >= 0
​
filled_size
number<double>
required
​
is_bid
boolean
required
​
market
string
required
Example:

"0xmarket123..."

​
price
number<double>
required
​
sequence_number
integer<int64>
required
Required range: x >= 0
Example:

12345

​
trade_id
string
required
Example:

"3647276"

​
transaction_unix_ms
integer<int64>
required
Example:

1730841600000

​
transaction_version
integer<int64>
required
Required range: x >= 0
Example:

12345

​
user
string
required
Example:

"0x123..."