Build with AI#

OnchainOS Market give agents and developers a unified data layer for real-time on-chain intelligence, token prices, trading activity, candlestick charts, token discovery, wallet balances, and transaction history , all from a single integration.

Use it as the research and monitoring layer that runs alongside trade execution, or independently for portfolio dashboards and opportunity detection.

Why OnchainOS Market for AI#

Dual-source price aggregation. Market Price data is aggregated in real time from both on-chain DEX activity and centralized exchange feeds, giving a more complete picture of a token's true market price than any single-venue source. For agents that need a manipulation-resistant reference , stop-loss thresholds, risk parameters, multi-step trade validation, the Index Price API computes a stable composite price from multiple independent third-party sources (CEX, DEX, oracles), specifically designed to resist single-venue distortion.
Token intelligence from discovery to depth. The Token API is a full information stack: search by name, symbol, or contract address; retrieve basic metadata (decimals, contract); pull live trading metrics (24h volume, market cap, circulating supply, holders, liquidity); surface trending tokens by price change, volume, or market cap; and inspect the top 20 holder addresses for concentration analysis. An Agent can go from a user's natural language question ("what's trending on Ethereum today?") to a structured, actionable answer without leaving the tool.
Complete portfolio visibility in one call. The Balance API queries token balances and total USD portfolio value across all supported chains simultaneously , no need to iterate per chain. This is designed for agents that manage multi-chain portfolios or need to verify sufficient balance before executing a swap.
Candlestick history for analysis and backtesting. The Market Price API provides OHLCV data from minute-level to daily candles, with a historical endpoint that extends the lookback window for trend analysis, pattern detection, and strategy backtesting.
Agent-optimized interface Skill and MCP Server. OKX Market provides two integration paths depending on how your Agent is deployed. The Skill teaches your Agent how to call the OKX Web3 Market API through structured instructions and code generation. The MCP Server exposes the same capabilities as directly callable tools via the Model Context Protocol.

Quickstart#

Add the Skill files to the Agent’s skill directory. The Agent will automatically load the intent router, chain-specific execution playbooks, signing modes, and error-handling logic.

skills：npx skills add okx/onchainos-skills

For Claude Desktop, Cursor, and other MCP-compatible clients, add the following configuration:

# for cursor
{
  "mcpServers": {
    "okx/onchainos-mcp": {
      "url": "https://web3.okx.com/api/v1/onchainos-mcp",
      "headers": {
        "OK-ACCESS-KEY": "your apiKey applyed on https://web3.okx.com/zh-hans/onchain-os/dev-portal/project"
      }
    }
  }
}
# for Claude code
{
  "mcpServers": {
    "okx/onchainos-mcp": {
      "url": "https://web3.okx.com/api/v1/onchainos-mcp",
      "headers": {
        "OK-ACCESS-KEY": "your apiKey applyed on https://web3.okx.com/zh-hans/onchain-os/dev-portal/project"
      }
      "type": "http"
    }
  }
}

One MCP server covers both Market and Trade capabilities. Restart your client after updating the config.

Market API

Skills

Table of contents

Why OnchainOS Market for AI

Quickstart