> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inkyswap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Emperor of the INK (EOTI)

> Get the current Emperor of the INK - the daily Emperor token selected through competitive bidding

## Description

Returns information about the current Emperor of the INK (EOTI), which is the daily Emperor token that receives premium placement and visibility across the platform. The EOTI is selected through a competitive bidding system where projects can bid to become the Emperor for the next day. The endpoint automatically returns the current day's Emperor token based on the smart contract.

## Query Parameters

<ParamField query="includeBidData" type="boolean" default="false">
  Include bidding data such as current bid amount, next Emperor, and bidding history
</ParamField>

## Response

<ResponseField name="address" type="string">
  Token contract address
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO timestamp of token creation
</ResponseField>

<ResponseField name="owner" type="string">
  Creator's wallet address
</ResponseField>

<ResponseField name="name" type="string">
  Token name
</ResponseField>

<ResponseField name="ticker" type="string">
  Token symbol
</ResponseField>

<ResponseField name="description" type="string">
  Token description
</ResponseField>

<ResponseField name="image_url" type="string">
  Token logo URL
</ResponseField>

<ResponseField name="telegram" type="string">
  Telegram channel URL
</ResponseField>

<ResponseField name="twitter" type="string">
  Twitter/X profile URL
</ResponseField>

<ResponseField name="website" type="string">
  Official website URL
</ResponseField>

<ResponseField name="market_cap" type="number">
  Current market capitalization in ETH
</ResponseField>

<ResponseField name="funding_progress" type="number">
  Funding progress (0-1, where 1 means fully funded and live)
</ResponseField>

<ResponseField name="price_eth" type="number">
  Current token price in ETH
</ResponseField>

<ResponseField name="volume_24h" type="number">
  24-hour trading volume
</ResponseField>

<ResponseField name="price_change_24h" type="number">
  24-hour price change percentage
</ResponseField>

<ResponseField name="txns_24h_buys" type="number">
  Number of buy transactions in the last 24 hours
</ResponseField>

<ResponseField name="txns_24h_sells" type="number">
  Number of sell transactions in the last 24 hours
</ResponseField>

<ResponseField name="volume_1h" type="number">
  1-hour trading volume
</ResponseField>

<ResponseField name="price_change_1h" type="number">
  1-hour price change percentage
</ResponseField>

<ResponseField name="txns_1h_buys" type="number">
  Number of buy transactions in the last hour
</ResponseField>

<ResponseField name="txns_1h_sells" type="number">
  Number of sell transactions in the last hour
</ResponseField>

<ResponseField name="total_holders" type="number">
  Total number of token holders
</ResponseField>

<ResponseField name="top_10_percentage" type="number">
  Percentage of supply held by top 10 holders
</ResponseField>

<ResponseField name="dev_holding_percentage" type="number">
  Percentage of supply held by developer
</ResponseField>

<ResponseField name="bidData" type="object">
  Bidding information (only included if includeBidData=true)

  <Expandable title="Bid Data">
    <ResponseField name="currentBid" type="string">
      Current highest bid amount in wei
    </ResponseField>

    <ResponseField name="startBid" type="string">
      Starting bid amount for the current epoch in wei
    </ResponseField>

    <ResponseField name="lastBidAmount" type="string">
      Last bid amount in wei
    </ResponseField>

    <ResponseField name="lastBidTime" type="string">
      Timestamp of the last bid
    </ResponseField>

    <ResponseField name="lastBid" type="object">
      Formatted last bid information

      <Expandable title="Last Bid">
        <ResponseField name="amount" type="string">
          Bid amount in ETH
        </ResponseField>

        <ResponseField name="timestamp" type="number">
          Unix timestamp of the bid
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="nextBoostedToken" type="string">
      Address of the token that will be Emperor tomorrow
    </ResponseField>

    <ResponseField name="currentBoostedToken" type="string">
      Address of today's Emperor token
    </ResponseField>

    <ResponseField name="lastBoostedToken" type="string">
      Address of yesterday's Emperor token
    </ResponseField>

    <ResponseField name="isEpochTaken" type="boolean">
      Whether the current epoch has been claimed
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "address": "0x75e7A5316e44755FF4ad724ee45337D1Eef6895e",
    "created_at": "2024-01-10T08:15:00Z",
    "owner": "0xabcdef1234567890abcdef1234567890abcdef12",
    "name": "Emperor Token",
    "ticker": "EMPEROR",
    "description": "The reigning Emperor of the INK ecosystem",
    "image_url": "https://example.com/emperor-logo.png",
    "telegram": "https://t.me/emperortoken",
    "twitter": "https://twitter.com/emperortoken",
    "website": "https://emperortoken.com",
    "market_cap": 1250.5,
    "funding_progress": 1.0,
    "price_eth": 0.00125,
    "volume_24h": 450.8,
    "price_change_24h": 125.3,
    "txns_24h_buys": 892,
    "txns_24h_sells": 423
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://inkypump.com/api/eoti"

  curl -X GET "https://inkypump.com/api/eoti?includeBidData=true"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch('https://inkypump.com/api/eoti');
  const emperor = await response.json();

  const withBidData = await fetch('https://inkypump.com/api/eoti?includeBidData=true');
  const emperorWithBids = await withBidData.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get("https://inkypump.com/api/eoti")
  emperor = response.json()

  with_bid_data = requests.get(
      "https://inkypump.com/api/eoti",
      params={"includeBidData": "true"}
  )
  emperor_with_bids = with_bid_data.json()
  ```
</RequestExample>