Skip to main content
POST
/
4f8d8f4040bdacd1577bff8058438274
/
info
info (spotDeployState)
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "spotDeployState",
  "user": "0x0000000000000000000000000000000000000000"
}
'
{
  "deploymentEnabled": true,
  "totalDeployments": 123,
  "deploymentCost": "<string>",
  "maxSupply": "<string>",
  "minSupply": "<string>",
  "deploymentQueue": [
    {
      "deployer": "<string>",
      "tokenName": "<string>",
      "tokenSymbol": "<string>",
      "supply": "<string>",
      "queuePosition": 123,
      "estimatedDeployTime": 123
    }
  ],
  "recentDeployments": [
    {
      "tokenAddress": "<string>",
      "tokenName": "<string>",
      "tokenSymbol": "<string>",
      "deployer": "<string>",
      "deployTime": 123,
      "initialSupply": "<string>"
    }
  ],
  "systemStatus": "<string>"
}
The info endpoint with type: "spotDeployState" returns the Spot Deploy Auction state. It exposes per‑token genesis state and the current gas auction parameters used for spot token deployment.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

​
Request body

  • type (string, required) — The request type. Must be "spotDeployState" to retrieve spot deployment state information.
  • user (string, required) — Address in 42-character hexadecimal format. Can be zero address (0x0000000000000000000000000000000000000000) for global state information.

​
Response

The response is an object with two primary sections:

​
States

Array of token genesis entries. Each entry includes:
  • token (integer) — Token ID.
  • spec (object) — Token spec with:
    • name (string)
    • szDecimals (number)
    • weiDecimals (number)
  • fullName (string, optional)
  • spots (array of integers) — Spot pair indices associated with the token.
  • maxSupply (integer)
  • hyperliquidityGenesisBalance (string)
  • totalGenesisBalanceWei (string)
  • userGenesisBalances (array) — Tuples of [address, balance] in string form.
  • existingTokenGenesisBalances (array) — Tuples of [tokenIndex, balance] in string form.

​
Gas auction

Current auction parameters:
  • startTimeSeconds (integer) — Auction start time (seconds since epoch).
  • durationSeconds (integer) — Auction duration in seconds.
  • startGas (string) — Starting gas amount.
  • currentGas (string or null) — Current gas amount.
  • endGas (string, optional) — Ending gas amount when completed.

​
Understanding spot token deployment

Deployment process:
  • Users submit token deployment requests with specified parameters
  • Requests are queued and processed based on system capacity
  • Successful deployments create new tradeable spot tokens
  • Deployed tokens become available for spot trading
System parameters:
  • Deployment cost: Fee required to deploy new tokens
  • Supply limits: Minimum and maximum token supply constraints
  • Queue management: Fair processing of deployment requests
Token lifecycle:
  • Request submission: Users submit deployment parameters
  • Queue processing: Requests are processed in order
  • Token creation: Successful deployments create new tokens
  • Trading availability: Deployed tokens become tradeable

​
Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "spotDeployState", "user": "0x0000000000000000000000000000000000000000"}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info

​
Use case

The info endpoint with type: "spotDeployState" is useful for:
  • Auction monitoring: Read current gasAuction timing and gas parameters.
  • Genesis state inspection: Review token states and genesis balances.
  • Discovery: Identify tokens and spot indices associated with upcoming or configured deployments.
This endpoint is particularly valuable for token creators, market participants interested in new token launches, and platforms that need to monitor or facilitate spot token deployments on the Hyperliquid exchange. It provides essential visibility into the token deployment ecosystem and system operational status.

Body

application/json
​
type
enum<string>
default:spotDeployState
required

Request type to retrieve spot token deployment state information

Available options:
spotDeployState
​
user
string
default:0x0000000000000000000000000000000000000000
required

Address in 42-character hexadecimal format (can be zero address for global state)

Response

200 - application/json

Spot token deployment state and configuration information

Current state of spot token deployment system

​
deploymentEnabled
boolean

Whether new spot token deployments are currently enabled

​
totalDeployments
integer

Total number of tokens deployed on the spot system

​
deploymentCost
string

Cost to deploy a new spot token (in USD)

​
maxSupply
string

Maximum token supply allowed for new deployments

​
minSupply
string

Minimum token supply required for new deployments

​
deploymentQueue
object[]

Queue of pending token deployments

​
recentDeployments
object[]

Recently deployed tokens

​
systemStatus
string

Current status of the deployment system (e.g., 'active', 'maintenance', 'paused')

Last modified on October 19, 2025