dexscreener-openapi-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

DexScreener API Skill

DexScreener API Skill

Use this skill to run DexScreener public market data operations through
uxc
+ OpenAPI.
Reuse the
uxc
skill for shared execution, auth, and error-handling guidance.
使用此Skill通过
uxc
+ OpenAPI执行DexScreener公开市场数据操作。
复用
uxc
Skill以获取共享的执行、认证和错误处理指引。

Prerequisites

前置条件

  • uxc
    is installed and available in
    PATH
    .
  • Network access to
    https://api.dexscreener.com
    .
  • Access to the curated OpenAPI schema URL:
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/dexscreener-openapi-skill/references/dexscreener-public.openapi.json
  • uxc
    已安装并在
    PATH
    中可用。
  • 可访问
    https://api.dexscreener.com
    的网络权限。
  • 可访问精心整理的OpenAPI schema URL:
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/dexscreener-openapi-skill/references/dexscreener-public.openapi.json

Scope

适用范围

This skill covers a read-first DexScreener surface for:
  • token profile discovery
  • latest and top token boosts
  • pair search by free-text query
  • pair lookup by chain and pair address
  • token market lookup by chain and token address list
This skill does not cover:
  • write operations
  • private or authenticated workflows
  • every DexScreener endpoint
  • trading or wallet execution
此Skill覆盖以读取优先的DexScreener操作范围,包括:
  • 代币资料发现
  • 最新及热门代币涨幅
  • 通过自由文本查询搜索交易对
  • 通过链和交易对地址查询交易对
  • 通过链和代币地址列表查询代币市场信息
此Skill 覆盖:
  • 写入操作
  • 私有或需认证的工作流
  • 所有DexScreener端点
  • 交易或钱包执行操作

Authentication

认证

DexScreener public reads in this skill do not require authentication.
此Skill中的DexScreener公开读取操作无需认证。

Core Workflow

核心工作流

  1. Use the fixed link command by default:
    • command -v dexscreener-openapi-cli
    • If missing, create it:
      uxc link dexscreener-openapi-cli https://api.dexscreener.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/dexscreener-openapi-skill/references/dexscreener-public.openapi.json
    • dexscreener-openapi-cli -h
  2. Inspect operation schema first:
    • dexscreener-openapi-cli get:/token-profiles/latest/v1 -h
    • dexscreener-openapi-cli get:/latest/dex/search -h
    • dexscreener-openapi-cli get:/latest/dex/pairs/{chainId}/{pairId} -h
    • dexscreener-openapi-cli get:/tokens/v1/{chainId}/{tokenAddresses} -h
  3. Prefer narrow reads before broader scans:
    • dexscreener-openapi-cli get:/token-profiles/latest/v1
    • dexscreener-openapi-cli get:/token-boosts/latest/v1
    • dexscreener-openapi-cli get:/latest/dex/search q=solana
  4. Execute with key/value parameters:
    • dexscreener-openapi-cli get:/latest/dex/pairs/{chainId}/{pairId} chainId=solana pairId=GgzbfpKtozV6Hyiahkh2yNVZBZsJa4pcetCmjNtgEXiM
    • dexscreener-openapi-cli get:/tokens/v1/{chainId}/{tokenAddresses} chainId=solana tokenAddresses=So11111111111111111111111111111111111111112
  1. 默认使用固定链接命令:
    • command -v dexscreener-openapi-cli
    • 若缺失,创建链接:
      uxc link dexscreener-openapi-cli https://api.dexscreener.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/dexscreener-openapi-skill/references/dexscreener-public.openapi.json
    • dexscreener-openapi-cli -h
  2. 先检查操作schema:
    • dexscreener-openapi-cli get:/token-profiles/latest/v1 -h
    • dexscreener-openapi-cli get:/latest/dex/search -h
    • dexscreener-openapi-cli get:/latest/dex/pairs/{chainId}/{pairId} -h
    • dexscreener-openapi-cli get:/tokens/v1/{chainId}/{tokenAddresses} -h
  3. 优先进行窄范围读取,再进行宽范围扫描:
    • dexscreener-openapi-cli get:/token-profiles/latest/v1
    • dexscreener-openapi-cli get:/token-boosts/latest/v1
    • dexscreener-openapi-cli get:/latest/dex/search q=solana
  4. 使用键值参数执行:
    • dexscreener-openapi-cli get:/latest/dex/pairs/{chainId}/{pairId} chainId=solana pairId=GgzbfpKtozV6Hyiahkh2yNVZBZsJa4pcetCmjNtgEXiM
    • dexscreener-openapi-cli get:/tokens/v1/{chainId}/{tokenAddresses} chainId=solana tokenAddresses=So11111111111111111111111111111111111111112

Operations

操作列表

  • get:/token-profiles/latest/v1
  • get:/token-boosts/latest/v1
  • get:/token-boosts/top/v1
  • get:/latest/dex/search
  • get:/latest/dex/pairs/{chainId}/{pairId}
  • get:/tokens/v1/{chainId}/{tokenAddresses}
  • get:/token-profiles/latest/v1
  • get:/token-boosts/latest/v1
  • get:/token-boosts/top/v1
  • get:/latest/dex/search
  • get:/latest/dex/pairs/{chainId}/{pairId}
  • get:/tokens/v1/{chainId}/{tokenAddresses}

Guardrails

防护规则

  • Keep automation on the JSON output envelope; do not use
    --text
    .
  • Parse stable fields first:
    ok
    ,
    kind
    ,
    protocol
    ,
    data
    ,
    error
    .
  • Treat this v1 skill as read-only. Do not imply order entry, swaps, or wallet operations.
  • Keep
    q
    focused to a token, pair, chain, or symbol rather than broad crawler-style searches.
  • For
    tokenAddresses
    , start with a single address or a short comma-separated list before scaling up.
  • DexScreener enforces endpoint-specific rate limits. Profile and boost endpoints are typically lower-throughput than pair and token lookup endpoints, so cache aggressively when polling discovery feeds.
  • DexScreener data is market-observation oriented and may be noisier on long-tail tokens than curated exchange-only feeds.
  • dexscreener-openapi-cli <operation> ...
    is equivalent to
    uxc https://api.dexscreener.com --schema-url <dexscreener_openapi_schema> <operation> ...
    .
  • 自动化操作仅针对JSON输出包;请勿使用
    --text
    参数。
  • 优先解析稳定字段:
    ok
    kind
    protocol
    data
    error
  • 将此v1 Skill视为只读工具。请勿用于下单、交换或钱包操作。
  • 保持
    q
    参数聚焦于单个代币、交易对、链或符号,而非爬虫式的宽泛搜索。
  • 对于
    tokenAddresses
    参数,先从单个地址或短逗号分隔列表开始,再逐步扩展。
  • DexScreener对不同端点实施特定的速率限制。资料和涨幅端点的吞吐量通常低于交易对和代币查询端点,因此轮询发现数据源时需积极缓存。
  • DexScreener数据以市场观测为导向,对于长尾代币,其数据可能比仅经过筛选的交易所数据源更嘈杂。
  • dexscreener-openapi-cli <operation> ...
    等效于
    uxc https://api.dexscreener.com --schema-url <dexscreener_openapi_schema> <operation> ...

References

参考资料