Skip to main content
GET
/
api
/
orders
Get orders
curl --request GET \
  --url https://api-testnet.mayybee.com/api/orders
[
  {
    "id": "ord_1704067200_abc123",
    "marketId": "jd7ay8vzqtcsyj48zyapp6aa9h7yfq2d",
    "tokenId": "25930605474857043641926317989588861972412542680030529942514995269236952683597",
    "maker": "0x7aDB49aE5DF789EE9B9F82614609967cCe4eE23d",
    "signer": "<string>",
    "taker": "0x0000000000000000000000000000000000000000",
    "side": 0,
    "makerAmount": "10000000000000000000",
    "takerAmount": "20000000000000000000",
    "filledAmount": "5000000000000000000",
    "salt": "1704067200123abc",
    "expiration": 1704153600,
    "nonce": "0",
    "feeRateBps": 0,
    "signatureType": 0,
    "signature": "<string>",
    "status": "open",
    "timestamp": 1704067200000,
    "smartWallet": "<string>"
  }
]

Query Parameters

​
maker
string

Filter orders by maker wallet address. Must be a valid Ethereum address.

​
marketId
string

Filter orders by market ID (Convex market identifier).

Response

Array of orders matching the filter

​
id
string

Unique order identifier generated by the backend. Format: ord_{unix_timestamp}_{random_6_chars}.

Example:

"ord_1704067200_abc123"

​
marketId
string

Market identifier from Convex database. Links this order to a specific prediction market.

Example:

"jd7ay8vzqtcsyj48zyapp6aa9h7yfq2d"

​
tokenId
string

ERC1155 token ID for the outcome token being traded. Large integer as decimal string (up to 78 digits).

Example:

"25930605474857043641926317989588861972412542680030529942514995269236952683597"

​
maker
string

Wallet address that created the order and owns the assets being traded. Checksummed 0x format.

Example:

"0x7aDB49aE5DF789EE9B9F82614609967cCe4eE23d"

​
signer
string

Address that signed the EIP-712 order. Usually same as maker, but can be a delegate with signing permission.

​
taker
string
default:0x0000000000000000000000000000000000000000

Specific counterparty address. Zero address (0x0000...0000) means any taker is allowed.

​
side
enum<integer>

Order side indicating direction. 0 = BUY (maker pays collateral, receives tokens). 1 = SELL (maker sells tokens, receives collateral).

Available options:
0,
1
​
makerAmount
string

Amount the maker is providing in wei (18 decimals). For BUY orders: collateral amount. For SELL orders: token amount.

Example:

"10000000000000000000"

​
takerAmount
string

Amount the maker expects to receive in wei (18 decimals). For BUY orders: token amount. For SELL orders: collateral amount.

Example:

"20000000000000000000"

​
filledAmount
string

Amount of takerAmount already filled by matching. Starts at '0'. When filledAmount == takerAmount, order is fully filled.

Example:

"5000000000000000000"

​
salt
string

Random value ensuring order uniqueness. Prevents replay attacks. Usually unix timestamp + random string.

Example:

"1704067200123abc"

​
expiration
integer

Unix timestamp (seconds) when the order expires. Orders past expiration are automatically rejected from matching.

Example:

1704153600

​
nonce
string
default:0

Order nonce for batch cancellation on-chain. Incrementing nonce cancels all orders with lower nonces.

​
feeRateBps
integer

Fee rate in basis points (1 bps = 0.01%). 100 = 1% fee. Currently 0 on testnet.

Required range: 0 <= x <= 1000
Example:

0

​
signatureType
enum<integer>

Signature type: 0 = EOA signature (personal_sign), 1 = EIP-712 typed data signature (recommended).

Available options:
0,
1
​
signature
string

EIP-712 signature of order struct. 65 bytes hex-encoded (r + s + v). For gasless orders, this is a placeholder.

​
status
enum<string>

Current order lifecycle status. 'open' = waiting for match, 'partial' = partially filled, 'filled' = fully executed, 'cancelled' = cancelled by maker.

Available options:
open,
partial,
filled,
cancelled
​
timestamp
integer

Unix timestamp (milliseconds) when the order was created. Used for time-priority matching.

Example:

1704067200000

​
smartWallet
string

Smart wallet address for hybrid wallet model. Holds wUSDT while EOA holds ERC1155 tokens. Optional.