Skip to main content
POST
/
info
info (preTransferCheck)
curl --request POST \
  --url https://api.hyperliquid.xyz/info \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "preTransferCheck",
  "user": "0x1442ad477ded1b0028b57621aa7b6f7eadb8f568",
  "source": "0x1442ad477ded1b0028b57621aa7b6f7eadb8f568"
}
'
{
  "isSanctioned": true,
  "userExists": true,
  "fee": "<string>",
  "userHasSentTx": true
}
You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet. See Hyperliquid methods for the full availability breakdown.
The info endpoint with type: "preTransferCheck" pre-flights a transfer to a destination address. It returns whether the destination is sanctioned, whether it already exists on Hyperliquid, the fee that would apply, and whether the user has previously transacted.
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 "preTransferCheck".
  • user (string, required) — Destination address in 42-character hexadecimal format.
  • source (string, required) — Source address in 42-character hexadecimal format.

Response

Returns a pre-transfer check object:
  • isSanctioned (boolean) — Whether the destination address is sanctioned.
  • userExists (boolean) — Whether the destination already exists on Hyperliquid.
  • fee (string) — The transfer fee that would apply.
  • userHasSentTx (boolean) — Whether the user has previously sent a transaction.

Example request

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "preTransferCheck", "user": "0x1442ad477ded1b0028b57621aa7b6f7eadb8f568", "source": "0x1442ad477ded1b0028b57621aa7b6f7eadb8f568"}' \
  https://api.hyperliquid.xyz/info

Example response

{
  "isSanctioned": false,
  "userExists": true,
  "fee": "0.0",
  "userHasSentTx": true
}

Use cases

The info endpoint with type: "preTransferCheck" is useful for:
  • Pre-flighting a transfer before submitting it
  • Surfacing the applicable fee to the user before sending
  • Sanctions screening of a destination address

Body

application/json
type
enum<string>
default:preTransferCheck
required

Request type

Available options:
preTransferCheck
user
string
default:0x1442ad477ded1b0028b57621aa7b6f7eadb8f568
required

Destination address in 42-character hexadecimal format.

source
string
default:0x1442ad477ded1b0028b57621aa7b6f7eadb8f568
required

Source address in 42-character hexadecimal format.

Response

200 - application/json

Pre-transfer check result for the destination user.

isSanctioned
boolean

Whether the address is sanctioned.

userExists
boolean

Whether the destination user already exists on Hyperliquid.

fee
string

Transfer fee that would apply.

userHasSentTx
boolean

Whether the user has previously sent a transaction.

Last modified on June 24, 2026