Earth2 API Wrapper

A powerful, open-source library for Node.js and Python to interact with the Earth2 API.

CLI Available

Node.js Support

Full TypeScript support for robust, type-safe development in the Node.js ecosystem.

npm install earth2-api-wrapper

Python Support

A simple and intuitive Python client, perfect for scripting, data analysis, and backend services.

pip install earth2-api-wrapper

Powerful CLI

Access Earth2 data directly from your terminal. Perfect for quick lookups and automation.

# Node.js CLI
e2 trending
e2 property <property-id>
e2 user <user-id>

# Python CLI
e2-py trending
e2-py property <property-id>
e2-py user <user-id>

Usage & Examples

import { Earth2Client } from 'earth2-api-wrapper';

// For public endpoints
const client = new Earth2Client();

// For authenticated endpoints
const clientWithAuth = new Earth2Client({
  cookieJar: process.env.E2_COOKIE,
  csrfToken: process.env.E2_CSRF,
});

async function getTrending() {
  const trendingPlaces = await client.getTrendingPlaces();
  console.log(trendingPlaces.data);
}

getTrending();

Authentication

For endpoints that require authentication (e.g., fetching your favorites or profile-specific data), you must provide your own credentials. The wrapper does not handle logging in for you.

You need to get your Cookie string and X-CSRF-TOKEN from your browser's developer tools after logging into the official Earth2 website.

It is highly recommended to store these as environment variables (E2_COOKIE and E2_CSRF) and not hardcode them in your scripts for security reasons.

How to get your credentials:

  1. Log in to the official Earth2 website.
  2. Open your browser's Developer Tools (usually by pressing F12 or right-clicking and selecting "Inspect").
  3. Go to the "Network" tab.
  4. Find and click on any recent API request (e.g., a request to r.earth2.io or app.earth2.io).
  5. In the "Headers" tab for that request, scroll down to "Request Headers".
  6. Find the cookie header. Copy the entire string value. This is your E2_COOKIE.
  7. Find the x-csrf-token header. Copy its value. This is your E2_CSRF.

Available API Endpoints

87+ Endpoints
v0.3.0

Complete Earth2 API coverage with TypeScript support and rate limiting

Tiles & Pricing
1

  • →getTilePricesAll()

Marketplace
2

  • →getMarketplace()
  • →getMarketFloor()

User Profile
5

  • →getUserInfo()
  • →getMyNetworth()
  • →getMyPreferences()
  • →getMyTileCountRankings()
  • →searchUsers()

Properties
7

  • →getLandfields()
  • →getLandfieldDetails()
  • →getLandfieldBalanceResources()
  • →getLandfieldSettings()
  • →getReceivedBids()
  • →getSentBids()
  • →getStakingCategoriesStats()

Jewels
5

  • →getMyJewels()
  • →getJewelData()
  • →getJewelStacks()
  • →getBazaarJewelOffers()
  • →getMyBazaarJewelOffers()

Blueprints
5

  • →getMyBlueprints()
  • →getBazaarBlueprintOffers()
  • →getTrendingBlueprintTags()
  • →anyBlueprintsForSale()
  • →getUserHolobuildingDesigns()

Droids
7

  • →getDroids()
  • →getDroidLandfields()
  • →getDroidRaidInfo()
  • →getDroidBuildInfo()
  • →getDroidPowerInfo()
  • →getDroidsTotalEthers()
  • →getBazaarDroidOffers()

Civilians
6

  • →getCivilians()
  • →getCivilianLandfields()
  • →getCivilianFeedInfo()
  • →getCivilianSynthesizeInfo()
  • →getCivilianEnergySkillPacksInfo()
  • →getBazaarCivilianOffers()

Resources
12

  • →getMyBalanceResources()
  • →getMyResourceBalance()
  • →getClaimableEtherAmount()
  • →getClaimableStakingYieldEther()
  • →getResourceClaims()
  • →getMyResourceStakes()
  • →getCurrentlyStakedResources()
  • →getResourceStakingRates()
  • →getMyResourceTransactions()
  • →getResourceManagementAssets()
  • →getLandfieldsResources()
    NEW
  • →getLandfieldResources()
    NEW

Leaderboards
5

  • →getLeaderboardPlayers()
  • →getLeaderboardCountries()
  • →getLeaderboardPlayerCountries()
  • →getPlayerContinentsLeaderboard()
  • →getLandfieldContinentsLeaderboard()

Essence & Crypto
5

  • →getEssenceTokenInfo()
  • →getEssUsdRate()
  • →getMyCryptoPayouts()
  • →getMetaMaskWalletConnection()
  • →getMyKYCTransactionStatus()

More Features
10

  • →getActivities()
  • →getQuests() / getMyQuests()
  • →getMentars() / getMentarDetails()
  • →getAvatarSales()
  • →getMyAvatarOwnerships()
  • →getYellowEnergyClaims()
  • →getTerritoryReleases()
  • →getCraftingRecipes()
  • →getMediaPlatforms()
  • →getLandingMetrics()

v0.3.0 Update - Complete Coverage!

Added 70+ new endpoints! Now with complete Earth2 API coverage including:

  • • Resources batch fetching (getLandfieldsResources)
  • • All leaderboard types (players, countries, continents)
  • • Crafting recipes & territory releases
  • • Complete droids, civilians, and jewels APIs
  • • Essence token info & crypto payouts
87+
Total Endpoints
23
Categories
100%
API Coverage
v0.3.0
Latest Version

This is an unofficial, community-driven project and is not affiliated with Earth2.

Contribute or report issues on the GitHub repository. GitHub repository