> ## Documentation Index
> Fetch the complete documentation index at: https://chainstack-docs-polygon-erigon-trace-deprecation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Gossip priority bid | Hyperliquid exchange
> Bid in the gossip priority auction to prioritize an IP address for gossip on Hyperliquid. On Hyperliquid exchange.
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](/docs/hyperliquid-methods) for the full availability breakdown.
This endpoint requires signature authentication. See our comprehensive [Authentication via Signatures guide](/docs/hyperliquid-authentication-guide) for implementation details.
The `gossipPriorityBid` action places a bid in the gossip priority auction to prioritize an IP address. Lower-indexed slots are strictly prioritized over higher ones. Use [gossipPriorityAuctionStatus](/reference/hyperliquid-info-gossip-priority-auction-status) to read the current auction state.
## Parameters
### Required parameters
* `action` (object, required) — The gossip-priority-bid action:
* `type` (string) — Must be `"gossipPriorityBid"`.
* `slotId` (number) — Auction slot identifier (`0` or `1`). Lower-indexed slots are strictly prioritized.
* `ip` (string) — The IP address (IPv4 or IPv6) to prioritize. Any address may bid on behalf of any IP.
* `maxGas` (number) — Max gas in wei (1 HYPE = 10^8 wei) charged from the spot balance. The minimum auction price is 0.1 HYPE.
* `nonce` (number, required) — Current timestamp in milliseconds.
* `signature` (object, required) — EIP-712 signature of the action.
### Optional parameters
* `expiresAfter` (number, optional) — Timestamp in milliseconds after which the request is rejected.
## Returns
Returns an object with the action status:
* `status` — `"ok"` if the request was processed.
* `response` — Contains operation details, with `type` `"default"`.
## Example request
```shell cURL theme={null}
curl -X POST https://api.hyperliquid.xyz/exchange \
-H "Content-Type: application/json" \
-d '{
"action": {"type": "gossipPriorityBid", "slotId": 0, "ip": "1.2.3.4", "maxGas": 10000000},
"nonce": 1234567890123,
"signature": {...}
}'
```
```python Python (hyperliquid-python-sdk) theme={null}
from hyperliquid.exchange import Exchange
from hyperliquid.utils import constants
import eth_account
# Public Hyperliquid mainnet endpoint
wallet = eth_account.Account.from_key("0x...") # your private key
exchange = Exchange(wallet, constants.MAINNET_API_URL)
# slot_id is 0 or 1; max_gas is in wei (1 HYPE = 1e8 wei)
result = exchange.gossip_priority_bid(slot_id=0, ip="1.2.3.4", max_gas=10000000)
print(result)
```
```typescript TypeScript (@nktkas/hyperliquid) theme={null}
import { ExchangeClient, HttpTransport } from "@nktkas/hyperliquid";
import { privateKeyToAccount } from "viem/accounts";
// Public Hyperliquid mainnet endpoint (default transport)
const wallet = privateKeyToAccount("0x..."); // viem or ethers account
const transport = new HttpTransport();
const exchange = new ExchangeClient({ transport, wallet });
const result = await exchange.gossipPriorityBid({
slotId: 0,
ip: "1.2.3.4",
maxGas: 10000000, // wei; 1 HYPE = 1e8 wei
});
console.log(result);
```
## Response example
```json theme={null}
{
"status": "ok",
"response": {
"type": "default"
}
}
```
## Use cases
* **Prioritize a node's gossip** — Win a priority slot for a given IP
* **Node operations** — Improve propagation for latency-sensitive infrastructure
* **Auction tooling** — Automate bidding against the current auction status
## OpenAPI
````yaml openapi/hyperliquid_node_api/hypercore_exchange/exchange_gossip_priority_bid.json post /exchange
openapi: 3.0.0
info:
title: Hyperliquid Exchange API
version: 1.0.0
description: >-
API for trading operations on Hyperliquid exchange requiring authentication.
⚠️ WARNING: These endpoints require EIP-712 signatures for authentication.
The example values provided will NOT work without proper cryptographic
signing. You must implement EIP-712 signing to use these endpoints
successfully.
servers:
- url: https://api.hyperliquid.xyz
security: []
paths:
/exchange:
post:
tags:
- hyperliquid exchange
summary: Bid in the gossip priority auction
operationId: gossipPriorityBid
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
action:
type: object
properties:
type:
type: string
default: gossipPriorityBid
enum:
- gossipPriorityBid
description: Action type
slotId:
type: integer
enum:
- 0
- 1
description: >-
Auction slot identifier (0 or 1). Lower-indexed slots
are strictly prioritized.
ip:
type: string
description: >-
IP address (IPv4 or IPv6) to prioritize. Any address may
bid on behalf of any IP.
maxGas:
type: integer
description: >-
Max gas in wei (1 HYPE = 10^8 wei) charged from spot
balance. Minimum auction price is 0.1 HYPE.
required:
- type
- slotId
- ip
- maxGas
nonce:
type: integer
description: Current timestamp in milliseconds
signature:
type: object
description: EIP-712 signature of the action with r, s, v components
properties:
r:
type: string
example: >-
0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
s:
type: string
example: >-
0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321
v:
type: integer
example: 27
required:
- r
- s
- v
expiresAfter:
type: integer
description: >-
Timestamp in milliseconds after which the request is
rejected (optional)
required:
- action
- nonce
- signature
example:
action:
type: gossipPriorityBid
slotId: 0
ip: 1.2.3.4
maxGas: 10000000
nonce: 1705234567890
signature:
r: >-
0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
s: >-
0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321
v: 27
responses:
'200':
description: Gossip priority bid result
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: Request status
response:
type: object
properties:
type:
type: string
default: default
example:
status: ok
response:
type: default
````