🔍 Check If a User is a MatchID User

You can verify whether a user already exists in the MatchID system by submitting the platform name and the unique user ID on that platform. This is info is available after your users login with MatchID. Remember to manage them properly within your facilities if needed.

🧭 Supported Platforms

Type	Platform Name	Platform UID Example
Social	Telegram, Twitter, Discord, GitHub, YouTube, Facebook, LinkedIn	1234567890 (user ID on that platform)
Wallet	EVM, BTC, TRON, TON, SOL	0x1234abcd... (wallet addr)
Email	Email	1234567890 (user ID on that platform)

✅ Endpoint

POST https://api.matchid.ai/api/v1/partner/user/exists

🧪 How to Check If a Wallet Has Staked MAT

There are 21 active staking pools on Matchain: checking if the user has staked in any of the 21 pools below should do

const stakingPoolAddresses = [
  "0xf9Ff433f14f237CE6643257ca4Cd5AEc355eaEE7",
  "0x256b02b26C67029B2881ab5d493cf8E5068D5Fcc",
  "0xa3BE9646116F834D0f9F1a035fdAd6862b5f0A2A",
  "0xfa38f584f561642Ff0d1AB67b5A175798668A047",
  "0x443D8318224C59c31987EA310033D0DC47A10d88",
  "0xc021A95E3Ad7D4e06745c4A12438A960c33859D7",
  "0xfF5Eb1345aa5d4C948C227742FCd32157539E480",
  "0x0B0381a2C4C3a537C614Afe71334c9F387718922",
  "0x9c4C30d5cD29c6D24CF1A712D93B756cBf5071bA",
  "0x8Aa82b86056af2DD5cdAAB45EEFE500c84d0af82",
  "0x4a47d64B074D730868623d89ec633d16adf53212",
  "0x739110f0233B8598957Af1321920787c13142910",
  "0xC3258AF62e46B502700c34ED7C3128F99f0fC532",
  "0xd899cd3cAFB1c9F6d585C36649592956D3dF5Ef9",
  "0xdB604bE88482cE061FBc2595E619f967dE1A7502",
  "0x96b5F62604729ED5b7219f1b3f15A8359E0a86Fb",
  "0xeEF37E218087Bca2f4c3c6C4c50f3D3B51B2Eb4d",
  "0xb4175a66e28F2C348959872B28AF0d12F891201F",
  "0xDD1904dcf7e0b6DFf60BD9729F626B076999E18f",
  "0x53F91B6aE02c8CDbC22565F7F7A158aDD6F1de6E",
  "0x0De1a88dcF7Fd12C54d9aC0807c990F26BD1C121"
];

📜 Get MatchID User Dapp Login History

You can retrieve the list of dapps a user has logged into using their MatchID credentials. This includes both Web3 wallet logins and social platform logins (e.g., Telegram, Twitter, Discord).

✅ Endpoint

POST https://api.matchid.ai/api/v1/partner/user/dapps/login/log

MAT Token Price API (CoinMarketCap)

You can query the live MAT token price in USD using the CoinMarketCap API with a JavaScript example.

🌐 API Provider

• Base URL: https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest
• Data Source: CoinMarketCap Pro API

🔹 Request Details

Endpoint

GET /v1/cryptocurrency/quotes/latest

MAT Total Supply

You can query the MAT token total supply in USD using the end point below.

Endpoint

GET https://supply-api.matchain.io/total-supply

MAT Circulating Supply

You can query the MAT token circulating supply in USD using the end point below.

Endpoint

GET https://supply-api.matchain.io/circulating-supply