API reference, Builder codes

Builder fills

Every fill of one builder code, with its builder fee, oid, tid and hash.

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

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)
`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/fills?limit=20"

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

Field	Type	Meaning
`fills[]`	object	Newest first: {block, eventIdx, time, user, entity, coin, side, px, sz, notional, crossed, dir, …}
`fills[].builderFee`	decimal	Builder fee of the fill, in feeToken
`fills[].notional`	decimal	px × sz, quote units
`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
`billing`	medium	medium

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 GET /v1/hypercore/builders/{builder}/orders HyperCore
Every status of the orders sent with one builder code, rejections and their reasons included.
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 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.