Epsilon is an MCP server published by io.github.alienbase-xyz, hosted at api.epsilon.exchange. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 22 tools, including cancel_order, check_order, get_approval, get_error_catalog, get_example.
Non-custodial limit, stop-loss and DCA trading on Epsilon (Robinhood Chain) for AI agents
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Ask the user to approve cancelling one of their open orders (hash from list_orders). Returns an approval link; the cancellation is signed by the user's wallet in the Epsilon app. Orders already filled cannot be cancelled.
| Parameter | Type | Description |
|---|---|---|
| note | string | optional reason shown to the user (≤ 140 chars) |
| orderHash * | string | EIP-712 order hash to cancel (0x-hex, 32 bytes) — from list_orders |
{
"name": "cancel_order",
"description": "Ask the user to approve cancelling one of their open orders (hash from list_orders). Returns an approval link; the cancellation is signed by the user's wallet in the Epsilon app. Orders already filled cannot be cancelled.",
"inputSchema": {
"type": "object",
"required": [
"orderHash"
],
"properties": {
"note": {
"type": "string",
"description": "optional reason shown to the user (≤ 140 chars)"
},
"orderHash": {
"type": "string",
"description": "EIP-712 order hash to cancel (0x-hex, 32 bytes) — from list_orders"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cancel Order (needs approval)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Check whether a resting order (limit, stop, DCA, trailing) for this pair and size would be executable: oracle support, liquidity, minimum size. Run this before signing any resting order; it does not price the trade — get_route does. Amounts are RAW token units.
| Parameter | Type | Description |
|---|---|---|
| tokenIn * | string | ERC-20 address of the token being sold (0x-hex) |
| amountIn * | string | amount of tokenIn in RAW token units (decimal string, already scaled by the token's decimals) |
| tokenOut * | string | ERC-20 address of the token being bought (0x-hex) |
{
"name": "check_order",
"description": "Check whether a resting order (limit, stop, DCA, trailing) for this pair and size would be executable: oracle support, liquidity, minimum size. Run this before signing any resting order; it does not price the trade — get_route does. Amounts are RAW token units.",
"inputSchema": {
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amountIn"
],
"properties": {
"tokenIn": {
"type": "string",
"description": "ERC-20 address of the token being sold (0x-hex)"
},
"amountIn": {
"type": "string",
"description": "amount of tokenIn in RAW token units (decimal string, already scaled by the token's decimals)"
},
"tokenOut": {
"type": "string",
"description": "ERC-20 address of the token being bought (0x-hex)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Order Preflight Check",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Status of an approval you created: pending (user hasn't decided), submitted (with orderHash or txHash — then use get_order to follow fills), rejected, failed, or expired (links live 30 minutes). Poll no more than every few seconds.
| Parameter | Type | Description |
|---|---|---|
| id * | string | approval id returned by a place_*/cancel_order call (apr_…) |
{
"name": "get_approval",
"description": "Status of an approval you created: pending (user hasn't decided), submitted (with orderHash or txHash — then use get_order to follow fills), rejected, failed, or expired (links live 30 minutes). Poll no more than every few seconds.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "approval id returned by a place_*/cancel_order call (apr_…)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Approval Status",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Machine-readable catalog of every error code the Epsilon API returns, with meanings and retry guidance. Consult it when any other tool returns an error code you need to interpret or decide whether to retry.
No parameters.
{
"name": "get_error_catalog",
"description": "Machine-readable catalog of every error code the Epsilon API returns, with meanings and retry guidance. Consult it when any other tool returns an error code you need to interpret or decide whether to retry.",
"inputSchema": {
"type": "object",
"additionalProperties": false
},
"annotations": {
"title": "API Error Catalog",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Full source code of one Epsilon integration example, by id from list_examples. No API key required.
| Parameter | Type | Description |
|---|---|---|
| id * | string | example id from list_examples, e.g. python-dca-cron |
{
"name": "get_example",
"description": "Full source code of one Epsilon integration example, by id from list_examples. No API key required.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "example id from list_examples, e.g. python-dca-cron"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Code Example",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}The signed-in account's agent grant for this channel, if any: the embedded wallet it signs with, per-order and daily caps, what remains today, allowed order kinds, and whether the Epsilon signer is actually granted on the wallet. Call it before placing to know whether an order will be placed immediately or need an approval link. Grants are created and revoked by the user in the Epsilon app, never by a tool.
No parameters.
{
"name": "get_grant",
"description": "The signed-in account's agent grant for this channel, if any: the embedded wallet it signs with, per-order and daily caps, what remains today, allowed order kinds, and whether the Epsilon signer is actually granted on the wallet. Call it before placing to know whether an order will be placed immediately or need an approval link. Grants are created and revoked by the user in the Epsilon app, never by a tool.",
"inputSchema": {
"type": "object",
"additionalProperties": false
},
"annotations": {
"title": "Get Agent Grant",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Market-level numbers for Epsilon (Robinhood Chain DEX). scope=overview (default) is the best first call: top tokens by 30-day volume, 24h volume, and engine-wide order/fill stats in one response. scope=engine returns only order counts by status, fill counts and volume aggregates; scope=volume returns per-token and total swap volume over window. For one token use search_tokens; for executed trades use list_fills.
| Parameter | Type | Description |
|---|---|---|
| scope | string | what to return: overview (default — top tokens by 30d volume + 24h volume + engine stats, the best first call), engine (order counts by status, fill counts, volume aggregates), or volume (per-token and total swap volume over window) |
| window | string | for scope=volume: 1h, 24h (default), 7d, 30d, or all |
{
"name": "get_market_stats",
"description": "Market-level numbers for Epsilon (Robinhood Chain DEX). scope=overview (default) is the best first call: top tokens by 30-day volume, 24h volume, and engine-wide order/fill stats in one response. scope=engine returns only order counts by status, fill counts and volume aggregates; scope=volume returns per-token and total swap volume over window. For one token use search_tokens; for executed trades use list_fills.",
"inputSchema": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"description": "what to return: overview (default — top tokens by 30d volume + 24h volume + engine stats, the best first call), engine (order counts by status, fill counts, volume aggregates), or volume (per-token and total swap volume over window)"
},
"window": {
"type": "string",
"description": "for scope=volume: 1h, 24h (default), 7d, 30d, or all"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Market Stats",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}The signed-in Epsilon account behind this session: account id, handle, linked wallets (embedded first), the scopes this client was granted, and which client is connected. Call it first after sign-in to learn the wallet address other tools need. Requires an OAuth session (connect to /mcp/account); on the keyless /mcp endpoint it explains how to sign in instead.
No parameters.
{
"name": "get_me",
"description": "The signed-in Epsilon account behind this session: account id, handle, linked wallets (embedded first), the scopes this client was granted, and which client is connected. Call it first after sign-in to learn the wallet address other tools need. Requires an OAuth session (connect to /mcp/account); on the keyless /mcp endpoint it explains how to sign in instead.",
"inputSchema": {
"type": "object",
"additionalProperties": false
},
"annotations": {
"title": "Who Am I",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}One Epsilon order by hash: status (pending/active/filled/cancelled/expired), parameters, and its fills. Use list_orders to find orders by wallet first; use get_orderbook for the market's resting orders on a pair.
| Parameter | Type | Description |
|---|---|---|
| orderHash * | string | EIP-712 order hash (0x-hex, 32 bytes) |
{
"name": "get_order",
"description": "One Epsilon order by hash: status (pending/active/filled/cancelled/expired), parameters, and its fills. Use list_orders to find orders by wallet first; use get_orderbook for the market's resting orders on a pair.",
"inputSchema": {
"type": "object",
"required": [
"orderHash"
],
"properties": {
"orderHash": {
"type": "string",
"description": "EIP-712 order hash (0x-hex, 32 bytes)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Order Status",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}The market's open (pending/active) limit orders on both sides of a token pair, largest first — liquidity you can rest against. For one wallet's own orders use list_orders instead.
| Parameter | Type | Description |
|---|---|---|
| tokenA * | string | first token address of the pair (0x-hex) |
| tokenB * | string | second token address of the pair (0x-hex) |
{
"name": "get_orderbook",
"description": "The market's open (pending/active) limit orders on both sides of a token pair, largest first — liquidity you can rest against. For one wallet's own orders use list_orders instead.",
"inputSchema": {
"type": "object",
"required": [
"tokenA",
"tokenB"
],
"properties": {
"tokenA": {
"type": "string",
"description": "first token address of the pair (0x-hex)"
},
"tokenB": {
"type": "string",
"description": "second token address of the pair (0x-hex)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Orderbook",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Best executable quote for swapping tokenIn → tokenOut on Epsilon (Robinhood Chain, id 4663): expected output and price. Use this for a quick price check; use get_route when you need the venue split, fee legs or minimum output for an order you will sign. Amounts are RAW token units — scale by the token's decimals first. Never executes.
| Parameter | Type | Description |
|---|---|---|
| tokenIn * | string | ERC-20 address of the token being sold (0x-hex) |
| amountIn * | string | amount of tokenIn in RAW token units (decimal string, already scaled by the token's decimals) |
| tokenOut * | string | ERC-20 address of the token being bought (0x-hex) |
{
"name": "get_quote",
"description": "Best executable quote for swapping tokenIn → tokenOut on Epsilon (Robinhood Chain, id 4663): expected output and price. Use this for a quick price check; use get_route when you need the venue split, fee legs or minimum output for an order you will sign. Amounts are RAW token units — scale by the token's decimals first. Never executes.",
"inputSchema": {
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amountIn"
],
"properties": {
"tokenIn": {
"type": "string",
"description": "ERC-20 address of the token being sold (0x-hex)"
},
"amountIn": {
"type": "string",
"description": "amount of tokenIn in RAW token units (decimal string, already scaled by the token's decimals)"
},
"tokenOut": {
"type": "string",
"description": "ERC-20 address of the token being bought (0x-hex)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Quote",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Full routing breakdown for a swap: best venue split, expected and minimum output, price impact (ppm), and the feeLegs a signed order must embed (pass orderType for a resting order so the right fee cell is served). Use get_quote for a plain price; use check_order to learn whether a resting order would be executable at all. Read-only. Amounts are RAW token units.
| Parameter | Type | Description |
|---|---|---|
| wallet | string | optional maker wallet address — include it to get the exact feeLegs an order for this wallet must embed |
| tokenIn * | string | ERC-20 address of the token being sold (0x-hex) |
| amountIn * | string | amount of tokenIn in RAW token units (decimal string, already scaled by the token's decimals) |
| tokenOut * | string | ERC-20 address of the token being bought (0x-hex) |
| orderType | string | order kind being priced (limit | stop_loss | take_profit | dca | trailing) — selects the fee cell served in feeLegs; omit for a direct swap |
| triggered | boolean | with orderType=dca: the schedule gates on a trigger (triggered DCA fee cell) |
| slippageBps | integer | slippage tolerance in basis points (default 100 = 1%) |
List runnable Epsilon integration examples (Python cron DCA, LangChain tools, Vercel AI SDK tools, Telegram bot). Fetch full source with get_example. No API key required.
No parameters.
{
"name": "list_examples",
"description": "List runnable Epsilon integration examples (Python cron DCA, LangChain tools, Vercel AI SDK tools, Telegram bot). Fetch full source with get_example. No API key required.",
"inputSchema": {
"type": "object",
"additionalProperties": false
},
"annotations": {
"title": "List Code Examples",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Executed trades (swaps and order fills) on Epsilon, newest first, optionally for one wallet — the trade history. For resting/open orders use list_orders. Amounts are RAW token units.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | max rows (default 100, cap 500) |
| wallet | string | optional wallet address to filter by |
{
"name": "list_fills",
"description": "Executed trades (swaps and order fills) on Epsilon, newest first, optionally for one wallet — the trade history. For resting/open orders use list_orders. Amounts are RAW token units.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "max rows (default 100, cap 500)"
},
"wallet": {
"type": "string",
"description": "optional wallet address to filter by"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Recent Swaps",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}A wallet's Epsilon orders filtered by status and/or type — the portfolio view, newest first. Use get_order for one order's fills; use list_fills for executed trades.
| Parameter | Type | Description |
|---|---|---|
| type | string | order type filter, e.g. limit, dca, trailing |
| limit | integer | max rows (default 100, cap 500) |
| status | string | order status filter, e.g. active, filled, cancelled |
| wallet | string | maker wallet address to filter by (0x-hex) |
{
"name": "list_orders",
"description": "A wallet's Epsilon orders filtered by status and/or type — the portfolio view, newest first. Use get_order for one order's fills; use list_fills for executed trades.",
"inputSchema": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "order type filter, e.g. limit, dca, trailing"
},
"limit": {
"type": "integer",
"description": "max rows (default 100, cap 500)"
},
"status": {
"type": "string",
"description": "order status filter, e.g. active, filled, cancelled"
},
"wallet": {
"type": "string",
"description": "maker wallet address to filter by (0x-hex)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Orders",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Ask the user to approve a DCA program: sell amount of tokenIn for tokenOut in `executions` equal slices, one every `every` (15m, 1h, 1d…). Optionally gated by triggerPrice (only sells at or below it). Keeper-executed after signing; always returns an approval link — DCA is never executed under an agent grant. HUMAN units; amount is the TOTAL.
| Parameter | Type | Description |
|---|---|---|
| note | string | optional one-line reason shown to the user (≤ 140 chars) |
| every * | string | interval between sells like 15m, 1h, 1d (minimum 1m) |
| amount * | string | TOTAL amount of tokenIn across the whole program, HUMAN units, decimal string |
| tokenIn * | string | ERC-20 address being sold in slices (0x-hex) |
| tokenOut * | string | ERC-20 address being accumulated (0x-hex) |
| executions * | integer | number of sells, 2–500; each sells amount/executions |
| slippageBps | integer | slippage tolerance per execution in basis points (default 100) |
| triggerPrice | string | optional: only sell while price is at or below this (tokenOut per tokenIn); omit to sell every interval regardless |
Place a resting limit order: sell amount tokenIn for tokenOut once the market reaches limitPrice (tokenOut per tokenIn) or better. Keeper-executed — it keeps working with the chat closed. If the user granted this client an agent grant and the order fits its caps, it is queued with a stable requestId (status reserved or submitted); otherwise you get an approval link the user signs in the Epsilon app (status needs_approval). Run check_order first. For a protective sell below the market use place_stop_order; for an immediate swap use place_market_order. HUMAN units.
| Parameter | Type | Description |
|---|---|---|
| note | string | optional one-line reason shown to the user (≤ 140 chars) |
| amount * | string | amount of tokenIn in HUMAN units, decimal string |
| tokenIn * | string | ERC-20 address being sold (0x-hex) |
| tokenOut * | string | ERC-20 address being bought (0x-hex) |
| expiresIn | string | optional lifetime like 7d, 24h, 30m; default: never |
| requestId | string | stable 32 lowercase hex characters for this trade; required for autonomous execution, reuse unchanged when retrying |
| limitPrice * | string | price in tokenOut per 1 tokenIn, decimal string (e.g. selling WETH for USDG at "4200") |
| slippageBps | integer |
Ask the user to approve a market swap of amount tokenIn → tokenOut at the best current route. Returns an approval link, not a fill: the user signs in the Epsilon app. Use get_quote first to tell the user what to expect. For a price-conditional order use place_limit_order or place_stop_order. Amounts are HUMAN units.
| Parameter | Type | Description |
|---|---|---|
| note | string | optional one-line reason shown to the user on the approval page (≤ 140 chars) |
| amount * | string | amount of tokenIn in HUMAN units, decimal string (e.g. "50" USDG, "0.25" WETH) — not raw units |
| tokenIn * | string | ERC-20 address being sold (0x-hex); resolve symbols with search_tokens first |
| tokenOut * | string | ERC-20 address being bought (0x-hex) |
| slippageBps | integer | slippage tolerance in basis points (default 100 = 1%, max 5000) |
{
"name": "place_market_order",
"description": "Ask the user to approve a market swap of amount tokenIn → tokenOut at the best current route. Returns an approval link, not a fill: the user signs in the Epsilon app. Use get_quote first to tell the user what to expect. For a price-conditional order use place_limit_order or place_stop_order. Amounts are HUMAN units.",
"inputSchema": {
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount"
],
"properties": {
"note": {
"type": "string",
"description": "optional one-line reason shown to the user on the approval page (≤ 140 chars)"
},
"amount": {
"type": "string",
"description": "amount of tokenIn in HUMAN units, decimal string (e.g. \"50\" USDG, \"0.25\" WETH) — not raw units"
},
"tokenIn": {
"type": "string",
"description": "ERC-20 address being sold (0x-hex); resolve symbols with search_tokens first"
},
"tokenOut": {
"type": "string",
"description": "ERC-20 address being bought (0x-hex)"
},
"slippageBps": {
"type": "integer",
"description": "slippage tolerance in basis points (default 100 = 1%, max 5000)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Place Market Order (needs approval)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Place a stop-loss: sell amount tokenIn for tokenOut if the price falls to triggerPrice (tokenOut per tokenIn). Keeper-executed. Queued under an active agent grant that covers it, otherwise returns an approval link (status needs_approval). Use place_limit_order to sell ABOVE the market (take profit); this tool is for protection BELOW it. Autonomous stops enforce a signed minimum and may remain unfilled after a price gap. HUMAN units.
| Parameter | Type | Description |
|---|---|---|
| note | string | optional one-line reason shown to the user (≤ 140 chars) |
| amount * | string | amount of tokenIn to sell, HUMAN units, decimal string |
| tokenIn * | string | ERC-20 address being sold when the stop triggers (0x-hex) |
| tokenOut * | string | ERC-20 address received (0x-hex), usually USDG |
| requestId | string | stable 32 lowercase hex characters for this trade; required for autonomous execution, reuse unchanged when retrying |
| slippageBps | integer | slippage tolerance for the fill in basis points (default 100) |
| triggerPrice * | string | stop trigger in tokenOut per 1 tokenIn, decimal string — strict floor stop order; may remain unfilled if the price gaps below its minimum |
Ask the user to approve a trailing stop: sell amount tokenIn for tokenOut when price drops trailPercent below its running high since placement. Keeper-executed after signing; always returns an approval link — trailing stops are never executed under an agent grant. For a fixed level use place_stop_order. HUMAN units.
| Parameter | Type | Description |
|---|---|---|
| note | string | optional one-line reason shown to the user (≤ 140 chars) |
| amount * | string | amount of tokenIn to sell, HUMAN units, decimal string |
| tokenIn * | string | ERC-20 address being protected / sold when the trail triggers (0x-hex) |
| tokenOut * | string | ERC-20 address received (0x-hex), usually USDG |
| expiresIn | string | optional lifetime like 7d, 30d; default 7d |
| slippageBps | integer | slippage tolerance for the fill in basis points (default 100) |
| trailPercent * | number | distance below the running high that triggers the sell, in percent (e.g. 5 = 5%); 0.1–99 |
Search the Epsilon developer documentation (API, auth, order signing, webhooks, rev-share, SDKs, MCP). Returns the most relevant doc sections. No API key required.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | max sections to return (default 5, cap 10) |
| query * | string | what to look for in the Epsilon developer docs, e.g. 'sign an order', 'rate limits', 'webhooks signature' |
{
"name": "search_docs",
"description": "Search the Epsilon developer documentation (API, auth, order signing, webhooks, rev-share, SDKs, MCP). Returns the most relevant doc sections. No API key required.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"description": "max sections to return (default 5, cap 10)"
},
"query": {
"type": "string",
"description": "what to look for in the Epsilon developer docs, e.g. 'sign an order', 'rate limits', 'webhooks signature'"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search Docs",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Resolve a token symbol or name to its address and decimals — call this FIRST when the user names a token; every other tool takes addresses. volume30dUsd disambiguates same-symbol tokens: the real one has volume.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | max rows (default 20, cap 100) |
| search | string | symbol or name fragment (e.g. USDG), or an exact 0x address; empty returns the top tokens by 30-day volume |
{
"name": "search_tokens",
"description": "Resolve a token symbol or name to its address and decimals — call this FIRST when the user names a token; every other tool takes addresses. volume30dUsd disambiguates same-symbol tokens: the real one has volume.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "max rows (default 20, cap 100)"
},
"search": {
"type": "string",
"description": "symbol or name fragment (e.g. USDG), or an exact 0x address; empty returns the top tokens by 30-day volume"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search Tokens",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "get_route",
"description": "Full routing breakdown for a swap: best venue split, expected and minimum output, price impact (ppm), and the feeLegs a signed order must embed (pass orderType for a resting order so the right fee cell is served). Use get_quote for a plain price; use check_order to learn whether a resting order would be executable at all. Read-only. Amounts are RAW token units.",
"inputSchema": {
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amountIn"
],
"properties": {
"wallet": {
"type": "string",
"description": "optional maker wallet address — include it to get the exact feeLegs an order for this wallet must embed"
},
"tokenIn": {
"type": "string",
"description": "ERC-20 address of the token being sold (0x-hex)"
},
"amountIn": {
"type": "string",
"description": "amount of tokenIn in RAW token units (decimal string, already scaled by the token's decimals)"
},
"tokenOut": {
"type": "string",
"description": "ERC-20 address of the token being bought (0x-hex)"
},
"orderType": {
"type": "string",
"description": "order kind being priced (limit | stop_loss | take_profit | dca | trailing) — selects the fee cell served in feeLegs; omit for a direct swap"
},
"triggered": {
"type": "boolean",
"description": "with orderType=dca: the schedule gates on a trigger (triggered DCA fee cell)"
},
"slippageBps": {
"type": "integer",
"description": "slippage tolerance in basis points (default 100 = 1%)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Swap Route",
"readOnlyHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| pauseOnRecovery |
| boolean |
| with triggerPrice: pause the program while price is back above the trigger |
{
"name": "place_dca_order",
"description": "Ask the user to approve a DCA program: sell amount of tokenIn for tokenOut in `executions` equal slices, one every `every` (15m, 1h, 1d…). Optionally gated by triggerPrice (only sells at or below it). Keeper-executed after signing; always returns an approval link — DCA is never executed under an agent grant. HUMAN units; amount is the TOTAL.",
"inputSchema": {
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount",
"every",
"executions"
],
"properties": {
"note": {
"type": "string",
"description": "optional one-line reason shown to the user (≤ 140 chars)"
},
"every": {
"type": "string",
"description": "interval between sells like 15m, 1h, 1d (minimum 1m)"
},
"amount": {
"type": "string",
"description": "TOTAL amount of tokenIn across the whole program, HUMAN units, decimal string"
},
"tokenIn": {
"type": "string",
"description": "ERC-20 address being sold in slices (0x-hex)"
},
"tokenOut": {
"type": "string",
"description": "ERC-20 address being accumulated (0x-hex)"
},
"executions": {
"type": "integer",
"description": "number of sells, 2–500; each sells amount/executions"
},
"slippageBps": {
"type": "integer",
"description": "slippage tolerance per execution in basis points (default 100)"
},
"triggerPrice": {
"type": "string",
"description": "optional: only sell while price is at or below this (tokenOut per tokenIn); omit to sell every interval regardless"
},
"pauseOnRecovery": {
"type": "boolean",
"description": "with triggerPrice: pause the program while price is back above the trigger"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Place DCA Order (needs approval)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| slippage tolerance for the fill in basis points (default 100) |
{
"name": "place_limit_order",
"description": "Place a resting limit order: sell amount tokenIn for tokenOut once the market reaches limitPrice (tokenOut per tokenIn) or better. Keeper-executed — it keeps working with the chat closed. If the user granted this client an agent grant and the order fits its caps, it is queued with a stable requestId (status reserved or submitted); otherwise you get an approval link the user signs in the Epsilon app (status needs_approval). Run check_order first. For a protective sell below the market use place_stop_order; for an immediate swap use place_market_order. HUMAN units.",
"inputSchema": {
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount",
"limitPrice"
],
"properties": {
"note": {
"type": "string",
"description": "optional one-line reason shown to the user (≤ 140 chars)"
},
"amount": {
"type": "string",
"description": "amount of tokenIn in HUMAN units, decimal string"
},
"tokenIn": {
"type": "string",
"description": "ERC-20 address being sold (0x-hex)"
},
"tokenOut": {
"type": "string",
"description": "ERC-20 address being bought (0x-hex)"
},
"expiresIn": {
"type": "string",
"description": "optional lifetime like 7d, 24h, 30m; default: never"
},
"requestId": {
"type": "string",
"description": "stable 32 lowercase hex characters for this trade; required for autonomous execution, reuse unchanged when retrying"
},
"limitPrice": {
"type": "string",
"description": "price in tokenOut per 1 tokenIn, decimal string (e.g. selling WETH for USDG at \"4200\")"
},
"slippageBps": {
"type": "integer",
"description": "slippage tolerance for the fill in basis points (default 100)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Place Limit Order (needs approval)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "place_stop_order",
"description": "Place a stop-loss: sell amount tokenIn for tokenOut if the price falls to triggerPrice (tokenOut per tokenIn). Keeper-executed. Queued under an active agent grant that covers it, otherwise returns an approval link (status needs_approval). Use place_limit_order to sell ABOVE the market (take profit); this tool is for protection BELOW it. Autonomous stops enforce a signed minimum and may remain unfilled after a price gap. HUMAN units.",
"inputSchema": {
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount",
"triggerPrice"
],
"properties": {
"note": {
"type": "string",
"description": "optional one-line reason shown to the user (≤ 140 chars)"
},
"amount": {
"type": "string",
"description": "amount of tokenIn to sell, HUMAN units, decimal string"
},
"tokenIn": {
"type": "string",
"description": "ERC-20 address being sold when the stop triggers (0x-hex)"
},
"tokenOut": {
"type": "string",
"description": "ERC-20 address received (0x-hex), usually USDG"
},
"requestId": {
"type": "string",
"description": "stable 32 lowercase hex characters for this trade; required for autonomous execution, reuse unchanged when retrying"
},
"slippageBps": {
"type": "integer",
"description": "slippage tolerance for the fill in basis points (default 100)"
},
"triggerPrice": {
"type": "string",
"description": "stop trigger in tokenOut per 1 tokenIn, decimal string — strict floor stop order; may remain unfilled if the price gaps below its minimum"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Place Stop Order (needs approval)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "place_trailing_order",
"description": "Ask the user to approve a trailing stop: sell amount tokenIn for tokenOut when price drops trailPercent below its running high since placement. Keeper-executed after signing; always returns an approval link — trailing stops are never executed under an agent grant. For a fixed level use place_stop_order. HUMAN units.",
"inputSchema": {
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount",
"trailPercent"
],
"properties": {
"note": {
"type": "string",
"description": "optional one-line reason shown to the user (≤ 140 chars)"
},
"amount": {
"type": "string",
"description": "amount of tokenIn to sell, HUMAN units, decimal string"
},
"tokenIn": {
"type": "string",
"description": "ERC-20 address being protected / sold when the trail triggers (0x-hex)"
},
"tokenOut": {
"type": "string",
"description": "ERC-20 address received (0x-hex), usually USDG"
},
"expiresIn": {
"type": "string",
"description": "optional lifetime like 7d, 30d; default 7d"
},
"slippageBps": {
"type": "integer",
"description": "slippage tolerance for the fill in basis points (default 100)"
},
"trailPercent": {
"type": "number",
"description": "distance below the running high that triggers the sell, in percent (e.g. 5 = 5%); 0.1–99"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Place Trailing Stop (needs approval)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}