@sperax/tool-dex-new-listings

Real-time new DEX token listing discovery with momentum scoring and risk analysis

DEX New Listings is an agent tool from SperaxOS, packaged headless so you can call it from any agent framework. It ships two things: the manifest — a JSON-Schema function definition a model can call — and the executor that runs the call against the real API.

There is no UI layer and no framework lock-in. It works anywhere TypeScript runs.

Install

npm install @sperax/tool-dex-new-listings

Usage

Call it directly

import { dexNewListingsExecutor } from '@sperax/tool-dex-new-listings';

const result = await dexNewListingsExecutor.invoke('getNewListings', {"chain":"<chain>","limit":1}, {
  messageId: 'msg-1',
});

console.log(result.content); // prose summary written for the model to read
console.log(result.state);   // typed data payload for your own UI

Give it to a model

import Anthropic from '@anthropic-ai/sdk';
import { DexNewListingsManifest, dexNewListingsExecutor } from '@sperax/tool-dex-new-listings';

const client = new Anthropic();

const response = await client.messages.create({
  model: 'claude-opus-4-8',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Ask something this tool can answer' }],
  tools: DexNewListingsManifest.api.map((api) => ({
    name: api.name,
    description: api.description,
    input_schema: api.parameters,
  })),
});

for (const block of response.content) {
  if (block.type !== 'tool_use') continue;
  const result = await dexNewListingsExecutor.invoke(block.name, block.input, { messageId: response.id });
  console.log(result.content);
}

DexNewListingsManifest.api is already in JSON-Schema form, so it maps onto any tool-calling API — Anthropic, OpenAI, the Vercel AI SDK, or an MCP server — without translation.

Every executor returns a BuiltinToolResult — { success, content, state }. content is prose written for the model to read; state is the typed data payload for your own code. Executors never throw: a failed call comes back as { success: false, content: '<reason>' }, so a network blip degrades the answer instead of crashing the agent loop.

Configuration

None. This tool calls a public API directly and needs no key or origin configuration.

Tool identifier

sperax-dex-new-listings

API reference

getNewListings

Fetch new token listings from DexScreener and GeckoTerminal across 950+ DEXs. Returns listings with momentum scores, risk flags, liquidity, and LP lock status. Supports filtering by chain, minimum liquidity, and minimum momentum score.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | chain | string | no | Blockchain network to filter by (e.g. "ethereum", "base", "bsc", "solana", "polygon_pos", "arbitrum", "avalanche"). Omit for all chains. | | limit | number | no | Maximum number of listings to return (default 10, max 50). | | minLiquidity | number | no | Minimum liquidity in USD (default 10000). Use higher values (50000+) to filter out low-quality listings. | | minMomentumScore | number | no | Minimum momentum score 0–100 (default 0). Use 50+ for high-quality launches. |

getListingDetail

Get full details for a specific new listing by token contract address and chain. Returns momentum score, risk flags, LP lock status, price changes, and transaction counts.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | chain | string | yes | Blockchain network (e.g. "ethereum", "base"). | | tokenAddress | string | yes | Token contract address (e.g. "0x1234..."). |

Types

Shared types come from @sperax/agent-tools-core: BuiltinToolManifest, BuiltinToolResult, BuiltinToolContext, and the BaseExecutor class every tool executor extends.

Related

• @sperax/agent-tools-core — the tool contract
• All SperaxOS agent tools — tool-dex-new-listings is one of many
• SperaxOS — the agent workspace these tools were built for

License

Apache-2.0