Skip to main content
GET
/
api
/
v1
/
markets
/
token
/
{token_id}
/
ticker
Get Ticker
curl --request GET \
  --url https://api.example.com/api/v1/markets/token/{token_id}/ticker
{
  "token_id": "<string>",
  "last_price": 123,
  "midpoint": 123,
  "best_bid": 123,
  "best_ask": 123
}

​
Usage

ticker = client.get_ticker(token_id="12345678901234567890")

​
Parameters

​
token_id
string
required
The outcome token ID to get pricing for.

​
Response

​
token_id
string
The token ID.
​
last_price
number
Last traded price.
​
midpoint
number
Midpoint between best bid and ask.
​
best_bid
number
Best (highest) bid price.
​
best_ask
number
Best (lowest) ask price.

​
Example

from polyhush import PolyhushClient

client = PolyhushClient(api_key="your-api-key")

ticker = client.get_ticker(token_id="12345678901234567890")

print(f"Token: {ticker['token_id']}")
print(f"Last Price: ${ticker['last_price']:.4f}")
print(f"Midpoint: ${ticker['midpoint']:.4f}")
print(f"Bid/Ask: ${ticker['best_bid']:.4f} / ${ticker['best_ask']:.4f}")

# Calculate spread
spread = ticker['best_ask'] - ticker['best_bid']
spread_pct = (spread / ticker['midpoint']) * 100
print(f"Spread: ${spread:.4f} ({spread_pct:.2f}%)")

​
Response

{
  "token_id": "12345678901234567890",
  "last_price": 0.5500,
  "midpoint": 0.5475,
  "best_bid": 0.5450,
  "best_ask": 0.5500
}

​
Use Cases

# Monitor price for trading signals
ticker = client.get_ticker(token_id)

if ticker['midpoint'] < 0.30:
    print("Price below threshold - consider buying")
elif ticker['midpoint'] > 0.70:
    print("Price above threshold - consider selling")

# Check spread before trading
ticker = client.get_ticker(token_id)
spread = ticker['best_ask'] - ticker['best_bid']

if spread > 0.05:
    print("Wide spread - use limit orders")
else:
    print("Tight spread - market orders OK")

# Calculate unrealized P&L
ticker = client.get_ticker(token_id)
positions = client.get_positions()

for pos in positions:
    if pos['token_id'] == token_id:
        pnl = (ticker['midpoint'] - pos['average_price']) * pos['size']
        print(f"Unrealized P&L: ${pnl:.2f}")
The midpoint is typically the best estimate of fair value and is useful for P&L calculations. Use best_bid/best_ask to estimate execution prices for orders.