Nomis API
Score Tokens

Score SBT

Request

GET https://nomis.cc/api/{slug}/holder?address={address}
is-holder.ts
import { type Res } from "./type"
 
export const isHolder = async (address: string) => {
  try {
    const res = await fetch(
      `https://nomis.cc/api/{slug}/holder?address=${address}`
    );
 
    if (!res.ok) throw new Error();
 
    const data = (await res.json()) as Res;
 
    if ("message" in data) throw new Error();
 
    return data.isHolder ?? false;
  } catch (error) {
    return false;
  }
};
 
console.log(await isHolder("0x..."))

Path Parameters

slug string Required
Nomis' Score slug.

ScoreSlug
Astar zkEVM logoAstar zkEVMastar-zkevm
Berachain Artio Testnet logoBerachain Artio Testnetberachain
Blast logoBlastblast
Blast Sepolia Testnet logoBlast Sepolia Testnetblast-sepolia
Core logoCorekroma
Cronos logoCronoscronos
Cross-Chain DeFi logoCross-Chain DeFirubic
Energi logoEnergienergi
Enuls logoEnulsenuls
EYWA logoEYWAeywa
Gnosis logoGnosisgnosis
Kroma logoKromakroma
LayerZero logoLayerZerolayerzero
LightLink logoLightLinklightlink
Linea logoLinealinea
Manta logoMantamanta
Metis logoMetismetis
Mint logoMintsei
Mode logoModemode
Moonbeam logoMoonbeammoonbeam
Multichain logoMultichainmultichain
Neon EVM logoNeon EVMneon
opBNB logoopBNBopbnb
Plume Testnet logoPlume Testnetplume
Polygon zkEVM logoPolygon zkEVMzkevm
Scroll logoScrollscroll
Sei logoSeisei
Taiko Katla Testnet logoTaiko Katla Testnettaiko
Web3 Social logoWeb3 Socialweb3social
ZetaChain Testnet logoZetaChain Testnetzetchain
ZKFair logoZKFairzkfair
zkLink Nova logozkLink Novazklink-nova
zkSync logozkSynczksync

Query Parameters

address string Required
Address of an account.

Response

Success

Success response will return when account address and score slug is valid.

Account with SBT

Nomis' Score holder.

// https://nomis.cc/api/blast/holder?address=0x2C0356a346471A6502EbEC941752a7FE43536422
{
  "owner": "0x2C0356a346471A6502EbEC941752a7FE43536422",
  "isHolder": true,
  "chainId": "81457",
  "version": "0.9",
  "calculationModel": "11",
  "score": 7.19,
  "tokenId": "2",
  "updated_s": "1709257523",
  "updated_ms": 1709257523000
}

Account without SBT

Not a Nomis' Score holder.

{
  "owner": "0x2C0356a346471A6502EbEC941752a7FE43536422",
  "isHolder": false,
  "chainId": "81457",
  "version": null,
  "calculationModel": "11",
  "score": null,
  "tokenId": null,
  "updated_s": null,
  "updated_ms": null
}

Error

Error response will return when:

  • Account address is invalid;
  • Score slug is invalid.
{
  "message": "Provided address is not a zksync address"
}