Order books
books.trades
Recent fills of one DeepBook pool, newest first.
Details
- Endpoint
- GET /v1/books/:pool/trades
- Credits
- 2
- Rate class
- Light. Counts against your light requests per second.
Returns fills of a DeepBook v3 pool from its OrderFilled events, newest first, 50 per page by default and at most 200. Each fill has the decimal price (quote per base), base size, quote size, which side the taker was on (buy or sell), the maker and taker balance manager and order id, the time and the transaction digest. Pass the cursor of the previous page to go further back. A page can hold fewer rows than limit with a cursor still set when the pool was quiet in the part of history that was searched: keep following the cursor until it is null.
Parameters
| Name | Type | Description |
|---|---|---|
| poolrequired | string | Pool object id (0x...). List them with books.list. |
| limit | integer | Fills per page, default 50.From 1 to 200. |
| cursor | string | Cursor from the previous page. |
Request
Send your key in the x-api-key header, or leave it out to use the keyless tier.
curl
curl "https://api.tide.ad/v1/books/0xe05dafb5133bcffb8d59f4e12465dc0e9faeaa05e3e342a08fe135800e3e4407/trades?limit=10" \
-H "x-api-key: YOUR_API_KEY"TypeScript
const res = await fetch("https://api.tide.ad/v1/books/0xe05dafb5133bcffb8d59f4e12465dc0e9faeaa05e3e342a08fe135800e3e4407/trades?limit=10", {
headers: {
"x-api-key": process.env.TIDE_API_KEY!,
},
});
const data = await res.json();Response
JSON
{
"poolId": "0xe05dafb5133bcffb8d59f4e12465dc0e9faeaa05e3e342a08fe135800e3e4407",
"items": [],
"cursor": null
}