IMXGold NFT marketplace
IMXGold Gods Unchained trading platform

Interested in API access?

Contact us on discord...

DATA TYPES

The following data can be accessed via the API.

Types

assets
Asset[]
collections
Collection[]
deposits
Deposit[]
matches
Match[]
mints
Mint[]
nft_collections
Collection[]
orders
Order[]
properties
Property[]
rank
Rank[]
tokens
Token[]
trades
Trade[]
transfers
Transfer[]
withdrawals
Withdrawal[]

IMX DATA SUMMARY

Get a list of all the data types and the id of the most recent page for each one.

Responses

Status Description Body
200 Success object A list of all the data types and the id of the most recent page for each one.
GET
/api?action=summary
200
{ "assets": { "last_page": 438027 }, "collections": { "last_page": 1 }, "deposits": { "last_page": 965 }, "mints": { "last_page": 428707 }, "nft_collections": { "0xacb3c6a43d15b907e8433077b6d38ae40936fe2c": { "rarity": { "last_page": 0 }, "proto": { "last_page": 2 }, "orders": { "last_page": -1 }, "metadata_schema": { "last_page": 0 }, "collection": { "last_page": 0 } } }, "orders": { "last_page": 1487194 }, "tokens": { "last_page": 1 }, "trades": { "last_page": 53848 }, "transfers": { "last_page": 191984 }, "withdrawals": { "last_page": 1059 } }

GET PAGE

This endpoint passes the json data downloaded from the IMX api at the matching page number. Pages can have variable amounts of records, typically from 50 to 200.

Parameters

Name Type Description
type string The type of data to get.
page number The page number to get.

Responses

Status Description Body
200 Success object The page of data.
GET
/api?action=get_page&type=orders&page=52000
200
{ "result": [...], "cursor": "eyJpZC...k4WiJ9", "remaining": 1 }

GET LATEST PAGE

This endpoint passes the json data downloaded from the IMX api at the matching page number. Pages can have variable amounts of records, typically from 50 to 200.

Responses

Status Description Body
200 Success object The page of data.
GET
/api?action=get_latest_page&type=trades
200
{ "result": [...], "cursor": "eyJpZC...k4WiJ9", "remaining": 0, "page": "53848" }

GU CARD RANKINGS

Returns proto_shines with total/recent history linear regressions, current price percentiles, and rankings for which are under/over valued.

Responses

Status Description Body
200 Success object The page of data.
GET
/api?action=get_gu_card_rankings
200
{ "proto_shine": {...}, "value_rank_all": {...}, "linear_fit_m_all": {...}, "linear_fit_b_all": {...}, "value_rank_recent": {...}, "linear_fit_m_recent": {...}, "linear_fit_b_recent": {...}, "sales": {...} }

PROTO STATS

Returns correlations for meteorite price vs the other shines of the same proto.

Parameters

Name Type Description
proto number The proto number to get.

Responses

Status Description Body
200 Success object The page of data.
200 Success object The image of the chart.
GET
/api?action=get_proto_stats&proto=231
200
{ "meteorite_price": [...], "shadow_price": [...], "gold_price": [...], "diamond_price": [...], "sales_lag": [...], "summary": { "meteorite_price": { "0_corr": 0.3670090505469872, "max_corr": 0.9999999999999999, "max_corr_sales_lag": 0 }, "shadow_price": { "0_corr": 0.04028717561241127, "max_corr": 1, "max_corr_sales_lag": -40 } } }
200
{ "src": "https://theta.casino/api.php?action=get_chart&chart_type=proto&proto=231" }

PROTO SHINE PRICE HISTORY

Returns the price history of all sales of the given proto_shine.

Parameters

Name Type Description
proto number/string The [shine-proto] number to get: 4-231 or just 231 for all shines.
compressed number Optional. Set to 1 if you want the data gzipped. Leave blank for json.

Responses

Status Description Body
200 Success object The page of data.
GET
/api?action=get_proto_shine_price_history&proto_shine=4-231
200
{ "order_id": [ 204982640, 218427898 ], "unix_time": [ 1654281733, 1658952682 ], "price_eth": [ 0.028, 0.033 ], "price_eth_with_fees": [ 0.0029400000000000003, 0.0034980000000000002 ] }

PROTO SHINE STATS

Returns correlations for eth price of this proto+shine vs usd/gods prices as well as against the median eth price of cards of the same shine/set/rarity.

Parameters

Name Type Description
proto number/string The [shine-proto] number to get: 4-231 or just 231 for all shines.

Responses

Status Description Body
200 Success object The page of data.
200 Success object The image of the chart.
GET
/api?action=get_proto_stats&proto=4-231
200
{ "eth_daily_price": [...], "gods_daily_price": [...], "median_shine_eth_price": [...], "median_set_eth_price": [...], "median_rarity_eth_price": [...], "sales_lag": [...], "summary": { "eth_daily_price": { "0_corr": -0.12394297255575652, "max_corr": 1, "max_corr_sales_lag": -237 }, "gods_daily_price": { "0_corr": -0.12394297255575652, "max_corr": 0.41458002584381437, "max_corr_sales_lag": 62 }, "median_shine_eth_price": { "0_corr": -0.02292146916466042, "max_corr": 1, "max_corr_sales_lag": -246 }, "median_set_eth_price": { "0_corr": -0.09178192581768466, "max_corr": 1, "max_corr_sales_lag": -246 }, "median_rarity_eth_price": { "0_corr": 0.0721105261085399, "max_corr": 1, "max_corr_sales_lag": -246 } } }
200
{ "src": "https://theta.casino/api.php?action=get_chart&chart_type=proto_shine&proto_shine=4-231" }

GET CRYPTO TOKENS

Get the top 1k crypto price and other token data. Updated every minute. Optionally supply a unix_time to get the price closest to that time. Optionally supply a ticker like BTC or ETH to get a specific token only. Data starts from Oct 2022.

Responses

Status Description Body
200 Success object The page of data.
GET
/api?action=get_tokens
200
[ { "name": "Ethereum", "symbol": "Ξ", "rank": 2, "age": 2637, "color": "#282a2a", "png32": "https://lcw.nyc3.cdn.digitaloceanspaces.com/production/currencies/32/eth.png", "png64": "https://lcw.nyc3.cdn.digitaloceanspaces.com/production/currencies/64/eth.png", "webp32": "https://lcw.nyc3.cdn.digitaloceanspaces.com/production/currencies/32/eth.webp", "webp64": "https://lcw.nyc3.cdn.digitaloceanspaces.com/production/currencies/64/eth.webp", "exchanges": 288, "markets": 4355, "pairs": 2171, "categories": [ "smart_contract_platforms" ], "allTimeHighUSD": 4861.288700810894, "circulatingSupply": 122373863, "totalSupply": 122373863, "maxSupply": null, "links": { "website": "https://www.ethereum.org/", "whitepaper": "https://github.com/ethereum/wiki/wiki/White-Paper", "twitter": "https://twitter.com/ethereum", "reddit": "https://reddit.com/r/ethereum", "telegram": null, "discord": "...", "medium": null, "instagram": null }, "code": "ETH", "rate": 1311.788862766358, "volume": 7596286377, "cap": 160528670577, "delta": { "hour": 0.9996, "day": 0.9837, "week": 1.0241, "month": 0.9842, "quarter": 0.848, "year": 0.3524 } } ]

GET TOKEN PRICE HISTORY

Returns minute-resolution price, volume, and supply data for the given token. Data starts from Oct 2022 and includes any token that was in the top 1k tokens on live coin watch since that date.

Parameters

Name Type Description
ticker string The ticker of the token to get data for.

Responses

Status Description Body
200 Success object The page of data.
GET
/api?action=get_token_price_history_csv&ticker=eth
200
",unixTime,circulatingSupply,totalSupply,maxSupply,rate,volume,cap,deltaHour,deltaDay,deltaWeek,deltaMonth,deltaQuarter,deltaYear 0,1666156765,122373863,122373863,,1304.645143439632,14957220935,159654466047,\n...\n0,1666158725,122373863,122373863,,1299.6708781344237,14739070899,159045745986,0.996,0.9754,1.0036,0.9941,0.8733,0.3396"

GET PROTOS PLAYED

Returns the number of wins, losses, and winrate for all protos played in ranked matches during the last 3 days.

Parameters

Name Type Description
compressed number Optional. Set to 1 if you want the data gzipped. Leave blank for json.

Responses

Status Description Body
200 Success object The data for all protos.
GET
/api?action=get_protos_played
200
"{\"1003\": {\"wins\": 7065, \"losses\": 6830, \"winrate\": 0.5084562792371357}, \"1046\": {\"wins\": 17404, \"losses\": 15757, \"winrate\": 0.5248333886191611}, ..., \"1100\": {\"wins\": 47384, \"losses\": 45907, \"winrate\": 0.5079160905124824}}"

GET MATCHES PLAYED

Returns decks and player info for all matches

Parameters

Name Type Description
god string Either all or the god played in the match (either win or loss).
compressed number Optional. Set to 1 if you want the data gzipped. Leave blank for json.

Responses

Status Description Body
200 Success object The data for matches played with the supplied god for the last 3 days.
GET
/api?action=get_matches_played&god=deception
200
"[{\"end_time\": 1670555471, \"total_rounds\": 5, \"winning_god\": \"light\", \"losing_god\": \"light\", \"winning_god_power\": 100115, \"losing_god_power\": 100115, \"winning_deck\": [327, 874, 874, 1000, 1000, 1063, 1147, 1147, 1286, 1286, 1290, 1340, 1340, 1413, 1413, 1426, 1435, 1435, 1501, 1501, 1507, 1511, 1511, 1523, 1524, 1672, 2010, 2010, 87005, 87005], \"losing_deck\": [231, 231, 376, 830, 1000, 1000, 1058, 1058, 1063, 1147, 1147, 1192, 1192, 1195, 1195, 1236, 1236, 1290, 1340, 1340, 1426, 1435, 1435, 1507, 1511, 1524, 2009, 2009, 2010, 2010], \"winning_player_rank_level\": 12, \"losing_player_rank_level\": 12},\n\t\t\t\t\t...\n\t\t\t\t\t{\"end_time\": 1670555473, \"total_rounds\": 5, \"winning_god\": \"light\", \"losing_god\": \"nature\", \"winning_god_power\": 100115, \"losing_god_power\": 100121, \"winning_deck\": [327, 830, 1000, 1000, 1061, 1147, 1147, 1192, 1192, 1236, 1286, 1286, 1290, 1290, 1340, 1340, 1426, 1432, 1432, 1435, 1435, 1501, 1501, 1502, 1507, 1511, 1511, 1523, 1524, 1672], \"losing_deck\": [106, 106, 886, 1018, 1018, 1043, 1045, 1045, 1046, 1046, 1100, 1100, 1101, 1101, 1117, 1117, 1166, 1166, 1235, 1235, 1257, 1257, 1313, 1316, 1316, 1470, 1470, 1574, 87004, 87004], \"winning_player_rank_level\": 10, \"losing_player_rank_level\": 9}]"

GET BOT SUMMARY

Returns the status of all cards transferred to any of the bots for a given address.

Parameters

Name Type Description
address string Required.

Responses

Status Description Body
200 Success object The data for all cards the owner address sent to any bot address and their status.
GET
/api?action=get_bot_summary&address=[ADDRESS]
200
"\"{\"0x97537b6144b6be037d7aad095cd7d225e88fc06eaa73538f032a9cc57fc70275\": {\"owner_address\": \"0x03a494b30a1a6fa005e7ce659c83c31cdcd70860\", \"received_time\": 1668328714.274129, \"sold_time\": 1668373148.275884, \"card_name\": \"Humble Benefactor\", \"proto_shine\": [\"1501\", \"4\"], \"status\": \"sold\", \"sold_price\": 60479400000000.0, \"list_price\": 0, \"token_id\": \"176972693\", \"id\": 152004781},..."