Skip to main content
GET
/
api
/
v1
/
bulk_orders
Get bulk orders
curl --request GET \
  --url https://api.mainnet.aptoslabs.com/decibel/api/v1/bulk_orders \
  --header 'Authorization: Bearer <token>'
[
  {
    "ask_prices": [
      101,
      102,
      103
    ],
    "ask_sizes": [
      1,
      2,
      3
    ],
    "bid_prices": [
      99,
      98,
      97
    ],
    "bid_sizes": [
      1,
      2,
      3
    ],
    "cancellation_reason": "<string>",
    "cancelled_ask_prices": [],
    "cancelled_ask_sizes": [],
    "cancelled_bid_prices": [
      100
    ],
    "cancelled_bid_sizes": [
      1
    ],
    "event_uid": 1,
    "market": "0xmarket123...",
    "sequence_number": 12345,
    "transaction_unix_ms": 1730841600000,
    "transaction_version": 12345,
    "user": "0x123...",
    "previous_seq_num": 12344
  }
]

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.

Response

Bulk orders retrieved successfully

​
ask_prices
number<double>[]
required
Example:
[101, 102, 103]
​
ask_sizes
number<double>[]
required
Example:
[1, 2, 3]
​
bid_prices
number<double>[]
required
Example:
[99, 98, 97]
​
bid_sizes
number<double>[]
required
Example:
[1, 2, 3]
​
cancellation_reason
string
required
​
cancelled_ask_prices
number<double>[]
required
Example:
[]
​
cancelled_ask_sizes
number<double>[]
required
Example:
[]
​
cancelled_bid_prices
number<double>[]
required
Example:
[100]
​
cancelled_bid_sizes
number<double>[]
required
Example:
[1]
​
event_uid
integer
required
Required range: x >= 0
​
market
string
required
Example:

"0xmarket123..."

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

12345

​
transaction_unix_ms
integer<int64>
required
Example:

1730841600000

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

12345

​
user
string
required
Example:

"0x123..."

​
previous_seq_num
integer<int64> | null
Required range: x >= 0
Example:

12344