API reference, Builder codes

Builder orders

Every status of the orders sent with one builder code, rejections and their reasons included.

GET https://api.femtos.xyz/v1/hypercore/builders/{builder}/orders

Parameters

Param	In	Example or values	Meaning
`builder`	path	`0xb84168cf3be63c6b8dad05ff5d755e97432ff80b`	Builder address (0x), as orders name it in `builder.b`
`from`	query	(optional)	Window start (Unix ms, default to − 24 h)
`to`	query	(optional)	Window end (Unix ms, exclusive, default now)
`status`	query	(optional)	One status
`coin`	query	(optional)	One market
`user`	query	(optional)	One account
`limit`	query	`20`	Rows
`cursor`	query	(optional)	Next page: `next_cursor` of the previous answer

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/hypercore/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/orders?limit=20"

Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.

Field	Type	Meaning
`orders[]`	object	Newest first: {block, eventIdx, time, user, entity, status, coin, side, oid, orderType, tif, limitPx, …}
`orders[].status`	string	Status as the node writes it: open, filled, canceled, triggered, badAloPxRejected…
`orders[].feeTenthsBp`	int	Builder fee the order charges, in tenths of a basis point (10 = 0.01 %)
`from`	ms	Window start read
`to`	ms	Window end
`next_cursor`	string \| null	Opaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page

Next page: cursor = the next_cursor of the previous answer, the same on every list (pagination).

Builder leaderboard GET /v1/hypercore/builders HyperCore
Every builder code ranked by fees, volume, users or orders, over 24 h to all time.
Builder GET /v1/hypercore/builders/{builder} HyperCore
One builder code: totals and rank, day by day, per market, order outcomes and fee rates.
Builder orders stream WS hc.builder.orders HyperCore
Every status of the orders sent with one builder code as it happens, rejections and their reasons included. One frame per block with all its matching events.
Builder fills GET /v1/hypercore/builders/{builder}/fills HyperCore
Every fill of one builder code, with its builder fee, oid, tid and hash.
Builder fills stream WS hc.builder.fills HyperCore
Every fill of one builder code as it happens, with its builder fee: the rows of the builder fills route, pushed per block. One frame per block with all its matching events.