DeFi & Trading

DEX swaps, cross-chain bridges, market data, token discovery, and on-chain history via OKX DEX integration.

Overview

AgentsWallets integrates with the OKX DEX aggregator to provide token swaps, cross-chain bridges, market data, token discovery, and on-chain transaction history. All DeFi operations support --idempotency-key, --dry-run, --force, and --yes flags.

DEX Swaps

Swap tokens on any supported chain via the OKX DEX aggregator.

`aw swap chains`

List supported chains for swaps. No unlock required.

aw swap chains --json

{
  "ok": true,
  "data": {
    "chains": [
      { "chain_id": 1, "name": "Ethereum" },
      { "chain_id": 56, "name": "BNB Chain" },
      { "chain_id": 8453, "name": "Base" },
      { "chain_id": 137, "name": "Polygon" },
      { "chain_id": 42161, "name": "Arbitrum" }
    ]
  }
}

`aw swap quote`

Get a swap quote without executing. No unlock required.

aw swap quote --from ETH --to USDC --amount 0.1 --chain ethereum --json

Flag	Required	Description
`--from <token>`	Yes	Source token symbol
`--to <token>`	Yes	Destination token symbol
`--amount <n>`	Yes	Amount of source token
`--slippage <n>`	No	Slippage tolerance in percent (default: 1)
`--chain <name>`	No	Target chain (default: `ethereum`)

{
  "ok": true,
  "data": {
    "from_token": "ETH",
    "to_token": "USDC",
    "from_amount": "0.1",
    "to_amount": "182.48",
    "slippage": "1",
    "price_impact": "0.05",
    "dex": "OKX DEX Aggregator"
  }
}

`aw swap exec`

Execute a token swap. Requires unlock.

aw swap exec \
  --wallet agent-01 \
  --from ETH \
  --to USDC \
  --amount 0.05 \
  --slippage 1 \
  --chain ethereum \
  --json

Flag	Required	Description
`--wallet <wallet>`	Yes	Wallet (name, address, or UUID)
`--from <token>`	Yes	Source token symbol
`--to <token>`	Yes	Destination token symbol
`--amount <n>`	Yes	Amount of source token
`--slippage <n>`	No	Slippage tolerance in percent (default: 1)
`--chain <name>`	No	Target chain (default: `ethereum`)
`--idempotency-key <k>`	No	Prevents duplicate swaps (auto-generated if omitted)
`--dry-run`	No	Validate without executing
`--force`	No	Bypass yellow-line Security Guard warnings
`--yes`	No	Confirm red-line Security Guard prompts

{
  "ok": true,
  "data": {
    "tx_hash": "0xabc...",
    "from_token": "ETH",
    "to_token": "USDC",
    "from_amount": "0.05",
    "to_amount": "91.24",
    "dex": "OKX DEX Aggregator",
    "chain": "Ethereum",
    "status": "confirmed"
  }
}

Cross-Chain Bridge

Bridge tokens between supported chains via OKX.

`aw bridge chains`

List supported bridge routes. No unlock required.

aw bridge chains --json

`aw bridge quote`

Get a bridge quote. No unlock required.

aw bridge quote \
  --from-chain ethereum \
  --to-chain base \
  --from-token ETH \
  --to-token ETH \
  --amount 0.1 \
  --json

Flag	Required	Description
`--from-chain <name>`	Yes	Source chain
`--to-chain <name>`	Yes	Destination chain
`--from-token <token>`	Yes	Source token symbol
`--to-token <token>`	Yes	Destination token symbol
`--amount <n>`	Yes	Amount of source token

{
  "ok": true,
  "data": {
    "from_chain": "Ethereum",
    "to_chain": "Base",
    "from_token": "ETH",
    "to_token": "ETH",
    "from_amount": "0.1",
    "to_amount": "0.0997",
    "bridge_fee": "0.0003",
    "estimated_time": "~5 minutes"
  }
}

`aw bridge exec`

Execute a cross-chain bridge. Requires unlock.

aw bridge exec \
  --wallet agent-01 \
  --from-chain ethereum \
  --to-chain base \
  --from-token ETH \
  --to-token ETH \
  --amount 0.1 \
  --json

Flag	Required	Description
`--wallet <wallet>`	Yes	Wallet (name, address, or UUID)
`--from-chain <name>`	Yes	Source chain
`--to-chain <name>`	Yes	Destination chain
`--from-token <token>`	Yes	Source token symbol
`--to-token <token>`	Yes	Destination token symbol
`--amount <n>`	Yes	Amount of source token
`--idempotency-key <k>`	No	Prevents duplicate bridges (auto-generated if omitted)
`--force`	No	Bypass yellow-line Security Guard warnings
`--yes`	No	Confirm red-line Security Guard prompts

{
  "ok": true,
  "data": {
    "tx_hash": "0xdef...",
    "bridge_id": "bridge_abc123",
    "from_chain": "Ethereum",
    "to_chain": "Base",
    "from_amount": "0.1",
    "to_amount": "0.0997",
    "status": "pending"
  }
}

`aw bridge status`

Check bridge transaction status. No unlock required.

aw bridge status --bridge-id bridge_abc123 --json

Flag	Required	Description
`--bridge-id <id>`	Yes	Bridge transaction ID

Market Data

Query real-time market data. No unlock required.

`aw market price`

Get token prices.

aw market price --token ETH --chain ethereum --json

Flag	Required	Description
`--token <symbol>`	Yes	Token symbol
`--chain <name>`	No	Chain (default: `ethereum`)

{
  "ok": true,
  "data": {
    "token": "ETH",
    "price_usd": "1824.80",
    "change_24h": "-2.3%",
    "chain": "Ethereum"
  }
}

`aw market candles`

Get OHLCV candle data.

aw market candles --token ETH --interval 1h --limit 24 --json

Flag	Required	Description
`--token <symbol>`	Yes	Token symbol
`--interval <period>`	No	Candle interval: `1m`, `5m`, `15m`, `1h`, `4h`, `1d` (default: `1h`)
`--limit <n>`	No	Number of candles (default: 24)
`--chain <name>`	No	Chain (default: `ethereum`)

`aw market trades`

Get recent trades.

aw market trades --token ETH --limit 10 --json

Flag	Required	Description
`--token <symbol>`	Yes	Token symbol
`--limit <n>`	No	Number of trades (default: 20)
`--chain <name>`	No	Chain (default: `ethereum`)

Token Discovery

Search and discover tokens. No unlock required.

`aw token search`

Search for tokens by keyword.

aw token search --keyword "pepe" --chain ethereum --json

Flag	Required	Description
`--keyword <text>`	Yes	Search keyword
`--chain <name>`	No	Chain (default: `ethereum`)

`aw token info`

Get detailed token information.

aw token info --address 0xA0b8...eB48 --chain ethereum --json

Flag	Required	Description
`--address <addr>`	Yes	Token contract address
`--chain <name>`	No	Chain (default: `ethereum`)

{
  "ok": true,
  "data": {
    "name": "USD Coin",
    "symbol": "USDC",
    "address": "0xA0b8...eB48",
    "decimals": 6,
    "total_supply": "26000000000",
    "holders": 2100000,
    "chain": "Ethereum"
  }
}

Get trending tokens.

aw token trending --chain ethereum --json

Flag	Required	Description
`--chain <name>`	No	Chain (default: `ethereum`)

`aw token holders`

Get top holders of a token.

aw token holders --address 0xA0b8...eB48 --chain ethereum --json

Flag	Required	Description
`--address <addr>`	Yes	Token contract address
`--chain <name>`	No	Chain (default: `ethereum`)

On-Chain History

Query on-chain transaction history. No unlock required.

`aw history list`

List on-chain transactions for a wallet.

aw history list --wallet agent-01 --limit 20 --chain ethereum --json

Flag	Required	Description
`--wallet <wallet>`	Yes	Wallet (name, address, or UUID)
`--limit <n>`	No	Max results (default: 20)
`--chain <name>`	No	Chain (default: `ethereum`)

{
  "ok": true,
  "data": {
    "transactions": [
      {
        "tx_hash": "0xabc...",
        "type": "swap",
        "from_token": "ETH",
        "to_token": "USDC",
        "amount": "0.05",
        "timestamp": "2026-03-15T10:30:00Z",
        "status": "confirmed"
      }
    ]
  }
}