Agent Shaniu (SHANIU)

Live SHANIU stats: total supply, claim pool remaining, claim count, current claim fee (wei of BNB, ~0.2 USD via Chainlink oracle), whether claiming is open, and optionally a wallet's balance / claimed status.

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Optional wallet to check balance and hasClaimed",
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Prepare an unsigned claim() (mint) transaction. Caller wallet must hold a Binance Agent ID (.ai); one claim per address; reward is a block-hash lottery (50-150 typical, up to 21,000; last claim sweeps the pool). Returns {to, data, valueWei} to sign with the user's wallet.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Wallet that will claim (gets the tokens)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List currently fillable sell orders on the on-chain order book, cheapest first. Each order: id, maker, remainingSHANIU, priceBNBperToken. No AMM pool exists — buying fills these orders atomically.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "Max orders to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Prepare an unsigned buy transaction that fills one or more sell orders. Computes exact BNB cost. Single order uses the market contract; multiple orders use the cart contract (buyMany) in one tx.

{
  "type": "object",
  "properties": {
    "fills": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Order id"
          },
          "amountSHANIU": {
            "type": "string",
            "description": "Amount to buy, e.g. \"100\""
          }
        },
        "required": [
          "id",
          "amountSHANIU"
        ]
      }
    }
  },
  "required": [
    "fills"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Prepare unsigned transactions to list SHANIU for sale: (1) approve the market contract, (2) list(amount, priceWei). The tokens stay in the seller's wallet until filled — the market is authorization-based, no custody.

{
  "type": "object",
  "properties": {
    "amountSHANIU": {
      "type": "string",
      "description": "Total amount to list, e.g. \"817\""
    },
    "priceBNBperToken": {
      "type": "string",
      "description": "BNB price per 1 SHANIU, e.g. \"0.0000078\""
    }
  },
  "required": [
    "amountSHANIU",
    "priceBNBperToken"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Referral program stats: global slots/budget usage, and (with address) one inviter's bound count, earned and pending SHANIU. Invite link format: https://bn.shaniu.ai/?ref=<address>

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Register a referral binding. Prefer mode=intent BEFORE the invitee calls claim(); or bind after the fact with the invitee's claim tx hash. Always ask your user for consent first. Rewards (10/50/200/1000 SHANIU tiers) roll automatically and are paid in batches.

{
  "type": "object",
  "properties": {
    "inviter": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "invitee": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "claimTx": {
      "description": "Omit for pre-claim intent registration",
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "inviter",
    "invitee"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}