Skip to content
Alchemy Logo

Spot deployment state

This API is in private preview. Target October 2026; timing is subject to change.

Returns the caller's spot-token deployment states and the current deployment auction.

Available now. This read is served at the interim endpoint today.

POST /{apiKey}/info

ParameterTypeRequiredDescription
typestringYesSelects spotDeployState.
userstringYesMaster or sub-account address.
{
  "type": "spotDeployState",
  "user": "0x0000000000000000000000000000000000000000"
}

FieldTypeDescription
states[]arrayDeployment-state entries.
states[].tokenintegerNumeric token index assigned to the deployment.
states[].specobjectRegistration configuration submitted for the token.
states[].spec.namestringDisplay name requested for the token.
states[].spec.szDecimalsintegerNumber of decimal places accepted for order sizes.
states[].spec.weiDecimalsintegerDecimal places in the token’s smallest unit.
states[].fullNamestring | nullFull token name, or null when not supplied.
states[].spotsarraySpot-pair indices already registered for the token.
states[].maxSupplyintegerMaximum token supply permitted by the deployment.
states[].hyperliquidityGenesisBalancestringGenesis allocation reserved for Hyperliquidity, as a decimal string.
states[].totalGenesisBalanceWeistringTotal genesis balance in the token’s smallest unit.
states[].userGenesisBalancesarrayAddress-and-balance pairs allocated at genesis.
states[].existingTokenGenesisBalancesarrayExisting-token index and genesis-balance pairs.
gasAuctionobjectCurrent Dutch-auction state for token deployment.
gasAuction.startTimeSecondsintegerUnix time in seconds when the auction starts.
gasAuction.durationSecondsintegerLength of the auction window in seconds.
gasAuction.startGasstringOpening auction gas price in HYPE.
gasAuction.currentGasstring | nullCurrent auction gas price, or null before it is available.
gasAuction.endGasstring | nullAuction end gas price, or null while the auction is open.

{
  "states": [
    {
      "token": 150,
      "spec": { "name": "HYPE", "szDecimals": 2, "weiDecimals": 8 },
      "fullName": "Hyperliquid",
      "spots": [107],
      "maxSupply": 1000000000
    }
  ],
  "gasAuction": {
    "startTimeSeconds": 1733929200,
    "durationSeconds": 111600,
    "startGas": "181305.90046",
    "currentGas": null,
    "endGas": "181291.247358"
  }
}
Was this page helpful?