get_status
GET /status — Check GrelfSwap API availability. Returns supported features, contract addresses, and SDK link. No wallet needed.
get_prices
GET /prices — Get current USD prices for one or more Hedera tokens. No wallet needed.
get_quote
GET /quote — Preview a swap quote before executing. Shows expected output, price impact, route, and fees. No wallet needed (wallet optional for prerequisite checks).
get_skill
GET /skill — Get the complete SKILL.md API documentation as markdown text. Comprehensive reference for all endpoints. No wallet needed.
get_sdk
GET /sdk.js — Get the hosted JavaScript signing helper SDK. Provides functions for signing and submitting Hedera transactions. No wallet needed.
get_balances
GET /balances — Get token balances for a Hedera wallet, grouped by source (HBAR, SaucerSwap, MemeJob). Zero balances filtered out. Requires wallet address.
execute_swap
POST /swap — Execute a token swap on Hedera via SaucerSwap or MemeJob. Returns unsigned transaction bytes to sign and submit. Requires wallet. Supports batch mode (HIP-551) for atomic multi-step swaps.
associate_token
POST /associate — Associate a token with a Hedera wallet. Required before receiving any HTS token. Returns unsigned transaction bytes to sign.
approve_allowance
POST /approve — Approve token spending allowance for GrelfSwap contracts. Required before swaps for HTS tokens (not needed for HBAR). Returns unsigned transaction bytes to sign.
transfer_tokens
POST /transfer — Transfer HBAR or HTS tokens between Hedera accounts. Returns unsigned transaction bytes to sign.
create_hcs_topic
POST /hcs/topic — Create a Hedera Consensus Service (HCS) topic. Returns unsigned transaction bytes to sign.
send_hcs_message
POST /hcs/message — Send a message to an existing HCS topic. Returns unsigned transaction bytes to sign.
create_smart_order
POST /smart-order — Create a limit order or DCA order on GrelfSwap. Supports four strategies: take profit, stop loss, buy cheaper, chase momentum. Requires wallet.
get_smart_orders
GET /smart-orders — List all smart orders (limit + DCA) for a wallet. Requires wallet address.
get_smart_order
GET /smart-order/:id — Get details of a specific smart order by ID. Requires wallet address for ownership verification.
cancel_smart_order
DELETE /smart-order/:id — Cancel an active smart order. Requires wallet address for ownership verification.