___                                     ___           ___     
     /  /\          ___                      /  /\         /  /\    
    /  /::\        /  /\                    /  /::\       /  /:/_   
   /  /:/\:\      /  /:/    ___     ___    /  /:/\:\     /  /:/ /\  
  /  /:/~/::\    /  /:/    /__/\   /  /\  /  /:/~/::\   /  /:/ /::\ 
 /__/:/ /:/\:\  /  /::\    \  \:\ /  /:/ /__/:/ /:/\:\ /__/:/ /:/\:\
 \  \:\/:/__\/ /__/:/\:\    \  \:\  /:/  \  \:\/:/__\/ \  \:\/:/~/:/
  \  \::/      \__\/  \:\    \  \:\/:/    \  \::/       \  \::/ /:/ 
   \  \:\           \  \:\    \  \::/      \  \:\        \__\/ /:/  
    \  \:\           \__\/     \__\/        \  \:\         /__/:/   
     \__\/                                   \__\/         \__\/    
     

Atlas: the open security master for real-world-asset and crypto perpetuals

Built and maintained by Aperiodic. Atlas is the open-source security master behind Aperiodic's RWA and crypto market data. Check out Aperiodic →

Search the catalogue → · Browse every perp A–Z on aperiodic.io →

Stocks, gold, oil, FX, indices and pre-IPO companies now trade as perpetuals on DeFi venues like Hyperliquid, Avantis, Lighter, GRVT, Aster, Variational, Extended, ApeX and Pacifica, and on centralised exchanges like Binance, Bybit, OKX, Bitget and Gate. No two venues name a market the same way. Atlas gives every contract one ID and every underlying asset one ID, the same on every venue, and keeps the contracts that were delisted.

• 7,000+ live RWA contracts: equities, commodities, FX, indices and pre-IPO, next to every crypto spot, perpetual and futures market.
• 57,000+ instruments on 28 venues (56 snapshots), 30,000+ of them delisted with the date they stopped trading.
• One asset registry: TSLA is Tesla on all 15 venues that list it.
• Plain JSON in git, refreshed daily from each venue's own API. No key, no network at lookup time.

Install

Python 3.12+.

pip install git+https://github.com/aperiodic-io/atlas

The snapshots ship with the package, so every lookup is a local dictionary read.

What it does, in five examples

1. One Tesla, nine spellings

Each venue names its Tesla perpetual differently. Lighter and Avantis use a bare number:

Venue	Native ID	Atlas ID (internal_id)	Atlas asset
Hyperliquid (HIP-3)	xyz:TSLA	perpetual-XYZ:TSLA-USDC:USDC	TSLA
Lighter	112	perpetual-TSLA-USDC:USDC	TSLA
Avantis	86	perpetual-TSLA-USDC:USDC	TSLA
Aster	tslausdt	perpetual-TSLA-USDT:USDT	TSLA
GRVT	TSLA_USDT_Perp	perpetual-TSLA-USDT:USDT	TSLA
Binance	tslausdt	perpetual-TSLA-USDT:USDT	TSLA

from atlas import SecurityMaster

sm = SecurityMaster.load()

sm.base_asset("lighter-perps", "112").asset_id        # 'TSLA'
sm.base_asset("avantis-perps", "86").asset_id         # 'TSLA'
sm.asset("TSLA")                                      # Tesla (Derivatives), equity
sm.exchanges_for_asset("TSLA")                        # 15 venues, DEX and CEX
sm.by_unified_id("perpetual-TSLA-USDC:USDC")          # every USDC-settled Tesla perp:
# [('avantis-perps', '86'), ('hyperliquid-perps', 'mkts:TSLA'),
#  ('hyperliquid-perps', 'xyz:TSLA'), ('lighter-perps', '112'),
#  ('pacifica-perps', 'TSLA'), ('variational-perps', 'TSLA')]

2. A ticker is not an asset

SPX is the S&P 500 to an equity trader, and SPX6900, a memecoin, on Aster, Lighter, ApeX, Extended and Variational. MON on four DEXs is filed by CoinMarketCap under a 2014 coin called MoneyByte; it is Monad. Atlas resolves identity from evidence (venue metadata, CoinMarketCap's own exchange listings, price checks, cross-venue consensus, curated pins), never from the ticker alone:

sm.base_asset("aster-perps", "spxusdt").name          # 'SPX6900'
sm.base_asset("hyperliquid-perps", "xyz:SP500").asset_class   # AssetClass.index
sm.base_asset("extended-perps", "MON-USD").name       # 'Monad'
sm.base_asset("bitget-perps-usdt", "AAPLUSDT").asset_id
# 'AAPL': the stock, not Ondo's AAPLON token that CMC files the market under

3. Every RWA contract trading on a given day

Filter by the asset class the venue declares, by venue, and by listing window:

from datetime import datetime

rwa = sm.instruments(
    underlying=["equity", "commodity", "forex", "index", "pre_market"],
    active_at=datetime(2026, 10, 29),
)
len(rwa)                                              # 7,493

sm.instruments(exchange="lighter-perps", underlying="forex")
# EURUSD, GBPUSD, AUDUSD, NZDUSD, USDJPY, USDCAD, USDCHF, USDHKD, USDKRW perps

4. FX has conventions; Atlas keeps them

Venues write the euro as EUR, EURUSD, EUR-USD or xyz:EUR, and the yen as USDJPY or a bare JPY quoted at ~158 yen per dollar. Atlas maps each to one currency-pair asset in market convention:

sm.base_asset("pacifica-perps", "EURUSD").asset_id    # 'EURUSD'
sm.base_asset("hyperliquid-perps", "xyz:JPY").asset_id  # 'USDJPY'
sm.instruments_for_asset("EURUSD")                    # Avantis, Bybit, Extended, Gate,
                                                      # Hyperliquid, Lighter, Pacifica

5. Backtests that remember the dead

Exchange APIs only list what trades today. Atlas keeps every delisted contract with its listing window, including 280 delisted RWA contracts such as Lighter's SpaceX pre-IPO perpetual (8 May to 19 June 2026):

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗