import { buyMarketplaceOrder, approveWETH, createProvider, Wallet } from "axie-tools";

const provider = createProvider(process.env.SKYMAVIS_API_KEY);
const wallet = new Wallet(process.env.PRIVATE_KEY, provider);

await approveWETH(wallet);
const receipt = await buyMarketplaceOrder(
  12345, // Axie ID
  wallet,
  process.env.MARKETPLACE_ACCESS_TOKEN,
  process.env.SKYMAVIS_API_KEY,
);

TypeScript SDK for building Axie Infinity trading bots and AI agents on Ronin network. Automate marketplace operations: buy, sell, list, and transfer Axies and Materials programmatically. Built-in floor price detection, batch transfers, and token management. Includes an interactive CLI for manual use.

Choose the entry point that matches how you want to use Axie Tools.

Run the CLI directly with npx:

npx axie-tools

The CLI downloads axie-tools and its runtime dependencies for that run. No project install is required.

Install the SDK in your project:

npm install axie-tools

ethers and dotenv are package dependencies, so npm install axie-tools is enough for Axie Tools itself. The examples below import common ethers helpers from axie-tools; add ethers or dotenv directly to your own project only if your application imports those packages itself.

Create a .env file for local CLI use or load the same values through your application runtime:

PRIVATE_KEY="your_ronin_wallet_private_key"
MARKETPLACE_ACCESS_TOKEN="your_access_token"
SKYMAVIS_API_KEY="your_api_key"
# Optional: override the default Ronin public RPC
RONIN_RPC_URL="https://api.roninchain.com/rpc"

For local Node.js 22+ scripts, you can load that file without adding another dependency:

node --env-file=.env your-script.mjs

You need:

• A Ronin wallet private key
• A marketplace access token from app.axieinfinity.com
• A SkyMavis API key from the Developer Console for marketplace API calls
• Optional: a custom Ronin RPC URL if you do not want to use the default public endpoint (https://api.roninchain.com/rpc)

import { getAxieFloorPrice, buyMarketplaceOrder, approveWETH, createProvider, Wallet } from "axie-tools";

const provider = createProvider(process.env.SKYMAVIS_API_KEY);
const wallet = new Wallet(process.env.PRIVATE_KEY, provider);

// Check the floor price first
const floorPrice = await getAxieFloorPrice(process.env.SKYMAVIS_API_KEY);
console.log(`Current floor: ${floorPrice} WETH`);

// Approve WETH spending (one-time)
await approveWETH(wallet);

// Buy a specific Axie
const receipt = await buyMarketplaceOrder(
  12345, // Axie ID to buy
  wallet,
  process.env.MARKETPLACE_ACCESS_TOKEN,
  process.env.SKYMAVIS_API_KEY,
);
console.log(`TX: https://app.roninchain.com/tx/${receipt.hash}`);

import {
  getAxieIdsFromAccount,
  createMarketplaceOrder,
  approveMarketplaceContract,
  createProvider,
  Wallet,
  parseEther,
} from "axie-tools";

const provider = createProvider(process.env.SKYMAVIS_API_KEY);
const wallet = new Wallet(process.env.PRIVATE_KEY, provider);
const address = await wallet.getAddress();

await approveMarketplaceContract(wallet);

const axieIds = await getAxieIdsFromAccount(address, provider);
const block = await provider.getBlock("latest");

for (const axieId of axieIds) {
  await createMarketplaceOrder(
    {
      address,
      axieId: axieId.toString(),
      basePrice: parseEther("0.01").toString(),
      endedPrice: "0",
      startedAt: block.timestamp,
      endedAt: 0,
      expiredAt: block.timestamp + 15634800,
    },
    process.env.MARKETPLACE_ACCESS_TOKEN,
    wallet,
    process.env.SKYMAVIS_API_KEY,
  );
}

Transaction helpers accept an optional GasPriceOptions parameter to customize gas pricing:

import { parseUnits, transferAxie, buyMarketplaceOrder } from "axie-tools";

// Use dynamic gas price from the network.
await transferAxie(signer, recipientAddress, axieId);

// Or pass a custom gas price.
const customGasPrice = parseUnits("30", "gwei");
await transferAxie(signer, recipientAddress, axieId, {
  gasPrice: customGasPrice,
});

await buyMarketplaceOrder(axieId, wallet, token, apiKey, {
  gasPrice: customGasPrice,
});

By default, transaction helpers fetch the current gas price from the network. If fetching fails, helpers fall back to 26 gwei.

Ready-to-use bot templates in the examples folder:

cd examples && npm install

# Snipe Axies below 0.001 WETH, check every 30 seconds
node floor-sniper.js 0.001 30

# List all your Axies at floor + 10%
node auto-lister.js 1.1

For manual operations and testing, use the interactive CLI:

npx axie-tools

The CLI provides: account info, token refresh, WETH/marketplace approvals, create/cancel/buy orders for Axies and Materials, auctions, bulk operations, and transfers. For automation, use the library directly.

git clone https://github.com/alexx855/axie-tools.git
cd axie-tools
npm install
npm run build

Log into app.axieinfinity.com, open dev tools, go to Application > Local storage > https://app.axieinfinity.com, and copy the accessToken value.

Screenshot showing where to find it

• Requires Node.js 22 or newer.
• All trading uses WETH, not ETH. Ensure your wallet has enough WETH before buying.
• Listing items is off-chain but requires contract approvals first. Buying and canceling are on-chain transactions.
• MARKETPLACE_ACCESS_TOKEN expires periodically. For long-running bots, use refreshToken() and getTokenExpirationInfo() to keep it fresh.
• Marketplace API and public RPC providers have rate limits. Use reasonable poll intervals (30s+) in bot loops.

Tests use Bun and require environment variables:

# Axie tests
AXIE_ID=123456 PRICE=0.1 bun test tests/create-order-axie.test.ts --timeout 30000
AXIE_ID=123456 bun test tests/cancel-order-axie.test.ts --timeout 30000
AXIE_ID=123456 bun test tests/settle-order-axie.test.ts --timeout 30000
bun test tests/create-orders-all-axies.test.ts --timeout 60000

# Material tests
MATERIAL_ID=1099511627776 QUANTITY=5 PRICE=0.001 bun test tests/create-order-materials.test.ts --timeout 30000
MATERIAL_ID=1099511627776 bun test tests/cancel-order-materials.test.ts --timeout 30000
MATERIAL_ID=1099511627776 QUANTITY=5 PRICE=0.001 bun test tests/settle-order-materials.test.ts --timeout 30000

# Floor price tests
AXIE_ID=1 bun test tests/axie-floor-price.test.ts --timeout 45000
MATERIAL_ID=1099511627776 bun test tests/material-floor-price.test.ts --timeout 30000

Check the Contributing Guidelines for details. Open an issue for bugs or ideas.

Released under the MIT License. See the LICENSE file.