saturnswap-pools

name	saturnswap-pools
description	Use this skill when the user asks about SaturnSwap pools, trading pairs, order books, token prices, or wants to find a specific pool. Triggers on: "show me pools", "find the MNT pool", "what pools are on SaturnSwap", "order book for", "best bid/ask", "token price", "pool TVL", "pool volume".
version	1.0.0

SaturnSwap Pool Discovery & Order Book

Query pools, order books, and token metadata on SaturnSwap DEX (Cardano).

Capabilities

• List pools sorted by volume or TVL
• Look up a specific pool by ID or token pair (policyId + assetName)
• View order book (bids and asks) for any pool
• Search token projects by ticker, policy ID, or market cap

API Reference

All queries hit https://api.saturnswap.io/v1/graphql/ — see shared/saturnswap-api.md for conventions.

Scripts

List Pools

node scripts/list-pools.js [--first N] [--order volume_24h|tvl] [--ticker MNT]

Returns pool ID, token pair tickers, 24h/7d/30d volume, and TVL.

Get Pool Details

node scripts/get-pool.js --id <pool-uuid>
node scripts/get-pool.js --policy <policyId> --asset <assetName>

Order Book

node scripts/order-book.js --pool <pool-uuid> [--side asks|bids|both] [--first N]

Search Tokens

node scripts/search-tokens.js [--ticker MNT] [--first N] [--order market_cap|volume_24h]

Key Concepts