Order books and Walrus
DeepBook pools, live depth, trades and a wallet's open orders, plus Walrus blobs by id or owner.
When to use it
- Show an order book and recent trades for a pool.
- List a wallet's open orders and fills.
- Check a Walrus blob's status, size and expiry.
Quickstart
Replace YOUR_API_KEY with your key from the developer portal, or drop the key header to use the keyless tier. See Quickstart.
1. List pools
Every DeepBook pool with its pair.
curl "https://api.tide.ad/v1/books" \
-H "x-api-key: YOUR_API_KEY"2. Read depth
Bids and asks for a pool, to the number of levels you ask for.
curl "https://api.tide.ad/v1/books/0xe05dafb5133bcffb8d59f4e12465dc0e9faeaa05e3e342a08fe135800e3e4407/depth?levels=10" \
-H "x-api-key: YOUR_API_KEY"3. Read a Walrus blob
Status, size, expiry epoch and owner.
curl "https://api.tide.ad/v1/walrus/blobs/0xcaa7c10b88a25af15bcad1ef9999e790c97b243a973a17e31cd68819664d5b6a" \
-H "x-api-key: YOUR_API_KEY"API reference
| Method | What it does | Credits |
|---|---|---|
| books.listGET /v1/books | Every DeepBook v3 pool with its coins, book parameters, best prices and 24 hour activity. | 2 |
| books.depthGET /v1/books/:pool/depth | Live bids and asks of one DeepBook pool, with mid price and spread. | 3 |
| books.tradesGET /v1/books/:pool/trades | Recent fills of one DeepBook pool, newest first. | 2 |
| wallet.ordersGET /v1/wallet/:wallet/orders | A wallet's DeepBook balance managers with their balances, open orders and recent fills. | 5 |
| walrus.blobGET /v1/walrus/blobs/:blobId | One Walrus blob: size, epochs, expiry, deletable flag, owner and status. | 2 |
| walrus.blobsGET /v1/wallet/:wallet/walrus-blobs | Walrus blobs a wallet owns, with epochs, size and expiry. | 2 |
Full lists: Order books, Walrus. Every method page has its parameters, credits and an example response.