The request is accepted on mainnet. HIP-3 star venue functionality is described as testnet-only in the upstream documentation. The mainnet example account has no recorded approvals.

Populated response format

The official testnet API returns dexToState as an array of [dexName, state] tuples. These two response variants were captured on testnet; they do not establish mainnet star venue availability.

{
	"dexToState": [
		[
			"ignp",
			{ "isReduceOnly": false, "isBackstopLiquidatorDepositAllowed": true }
		]
	]
}

When a venue has removed a user's approval, its state can be null:

{ "dexToState": [["nimb", null]] }

Parameters

type

string

REQUIRED

Info request type.

user

string

REQUIRED

User address in 42-character hexadecimal format.

Returns

dexToState

array

Array of [dexName, state] tuples. dexName is the venue name. state is null for a removed approval, or an object with boolean isReduceOnly and isBackstopLiquidatorDepositAllowed fields. An account with no recorded approvals returns an empty array. Populated and null tuple states were verified on the official testnet API.

tuple

array

Each array element is a two-element tuple. The numbered entries below are array positions, not object keys.

0

string

[0] dexName. HIP-3 star venue name.

1

object|null

[1] state. Current approval flags for the venue, or null if the venue removed the user’s approval. Populated and null states were verified on the official testnet API.

isReduceOnly

boolean

Whether the user is restricted to reduce-only trading on this venue.

isBackstopLiquidatorDepositAllowed

boolean

Whether the user may deposit into this venue’s backstop liquidator.

Request

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm -X POST -H 'Content-Type: application/json' --data '{"type": "userStarState", "user": "0xB228634b61636ADF82501eD196Bec979B6aF4732"}'
2

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm -X POST -H 'Content-Type: application/json' --data '{"type": "userStarState", "user": "0xB228634b61636ADF82501eD196Bec979B6aF4732"}'
2

1
fetch('https://docs-demo.hype-mainnet.quiknode.pro/evm', {
2
	method: 'POST',
3
	headers: { 'Content-Type': 'application/json' },
4
	body: JSON.stringify({
5
		type: 'userStarState',
6
		user: '0xB228634b61636ADF82501eD196Bec979B6aF4732',
7
	}),
8
})
9
	.then(response => {
10
		if (!response.ok) throw new Error(`HTTP ${response.status}`)
11
		return response.text()
12
	})
13
	.then(console.log)
14
	.catch(console.error)
15

1
fetch('https://docs-demo.hype-mainnet.quiknode.pro/evm', {
2
	method: 'POST',
3
	headers: { 'Content-Type': 'application/json' },
4
	body: JSON.stringify({
5
		type: 'userStarState',
6
		user: '0xB228634b61636ADF82501eD196Bec979B6aF4732',
7
	}),
8
})
9
	.then(response => {
10
		if (!response.ok) throw new Error(`HTTP ${response.status}`)
11
		return response.text()
12
	})
13
	.then(console.log)
14
	.catch(console.error)
15

1
import requests
2

3
response = requests.post('https://docs-demo.hype-mainnet.quiknode.pro/evm', json={'type': 'userStarState', 'user': '0xB228634b61636ADF82501eD196Bec979B6aF4732'}, timeout=30)
4
response.raise_for_status()
5
print(response.text)
6

1
import requests
2

3
response = requests.post('https://docs-demo.hype-mainnet.quiknode.pro/evm', json={'type': 'userStarState', 'user': '0xB228634b61636ADF82501eD196Bec979B6aF4732'}, timeout=30)
4
response.raise_for_status()
5
print(response.text)
6

1
require 'net/http'
2
require 'json'
3

4
uri = URI('https://docs-demo.hype-mainnet.quiknode.pro/evm')
5
request = Net::HTTP::Post.new(uri)
6
request['Content-Type'] = 'application/json'
7
request.body = '{"type": "userStarState", "user": "0xB228634b61636ADF82501eD196Bec979B6aF4732"}'
8
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') { |http| http.request(request) }
9
raise "HTTP #{response.code}" unless response.is_a?(Net::HTTPSuccess)
10
puts response.body
11

1
require 'net/http'
2
require 'json'
3

4
uri = URI('https://docs-demo.hype-mainnet.quiknode.pro/evm')
5
request = Net::HTTP::Post.new(uri)
6
request['Content-Type'] = 'application/json'
7
request.body = '{"type": "userStarState", "user": "0xB228634b61636ADF82501eD196Bec979B6aF4732"}'
8
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') { |http| http.request(request) }
9
raise "HTTP #{response.code}" unless response.is_a?(Net::HTTPSuccess)
10
puts response.body
11

Response

1
{
2
  "dexToState": []
3
}

1
{
2
  "dexToState": []
3
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free