curl https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40 \
-H "X-API-Key: $TOTALIS_API_KEY"
{
"data": {
"quote_request": {
"id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
"version": 3,
"request_hash": "sha256:a3f4b2c...",
"book_seq": 5,
"status": "active",
"bet_amount": 25,
"legs": [
{
"id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6",
"event_ticker": "KXBTC-26JUN01",
"market_ticker": "KXBTC-26JUN01-T72500",
"side": "yes",
"venue": "kalshi"
}
],
"input_legs": [
{"market_ticker": "KXBTC-26JUN01-T72500", "side": "yes", "venue": "kalshi"}
],
"expires_at": "2026-06-01T18:45:30.000Z"
},
"quotes": [
{
"id": "b2c3d4e5-6789-0abc-def1-234567890abc",
"market_maker_id": "mm-uuid-1234",
"payout_odds": 4.25,
"user_cost": 25,
"total_payout": 106.25,
"mm_cost": 81.25,
"valid_until": "2026-06-01T18:45:45.000Z",
"leg_prices": [
{"leg_id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6", "leg_odds": 0.42}
]
}
],
"best_quote": {
"id": "b2c3d4e5-6789-0abc-def1-234567890abc",
"payout_odds": 4.25,
"user_cost": 25,
"total_payout": 106.25,
"mm_cost": 81.25,
"valid_until": "2026-06-01T18:45:45.000Z"
}
}
}
Quote service
Get Quote Request
Retrieve a quote request with all active quotes and the current best quote.
GET
/
v1
/
quote-requests
/
{id}
curl https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40 \
-H "X-API-Key: $TOTALIS_API_KEY"
{
"data": {
"quote_request": {
"id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
"version": 3,
"request_hash": "sha256:a3f4b2c...",
"book_seq": 5,
"status": "active",
"bet_amount": 25,
"legs": [
{
"id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6",
"event_ticker": "KXBTC-26JUN01",
"market_ticker": "KXBTC-26JUN01-T72500",
"side": "yes",
"venue": "kalshi"
}
],
"input_legs": [
{"market_ticker": "KXBTC-26JUN01-T72500", "side": "yes", "venue": "kalshi"}
],
"expires_at": "2026-06-01T18:45:30.000Z"
},
"quotes": [
{
"id": "b2c3d4e5-6789-0abc-def1-234567890abc",
"market_maker_id": "mm-uuid-1234",
"payout_odds": 4.25,
"user_cost": 25,
"total_payout": 106.25,
"mm_cost": 81.25,
"valid_until": "2026-06-01T18:45:45.000Z",
"leg_prices": [
{"leg_id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6", "leg_odds": 0.42}
]
}
],
"best_quote": {
"id": "b2c3d4e5-6789-0abc-def1-234567890abc",
"payout_odds": 4.25,
"user_cost": 25,
"total_payout": 106.25,
"mm_cost": 81.25,
"valid_until": "2026-06-01T18:45:45.000Z"
}
}
}
Retrieve a quote request by ID. The response includes the full quote request object, all active quotes for the current version, and the computed best quote (highest payout odds).
Use this endpoint to check the current state of a quote request. For real-time updates, use the SSE stream instead.
A Privy JWT (
Authentication
API key required. Pass your API key in theX-API-Key header. The key needs the positions:read scope.
X-API-Key: <your-api-key>
Authorization: Bearer <jwt>) is also accepted — see Authentication.
Path parameters
string
required
The quote request ID (UUID).
Response
object
Show data
Show data
object
The quote request object including
id, version, status, bet_amount, legs, and expires_at.array
All active quotes for the current version.
Show Quote object
Show Quote object
string
Quote UUID.
string
The quoting market maker’s ID.
number
Payout multiplier on the bet amount.
number
Cost to the user in USDC.
number
Total payout if the parlay wins.
number
USDC the market maker puts at risk.
string
ISO 8601 timestamp when this quote expires.
array
Per-leg pricing with
leg_id and leg_odds.object
The quote with the highest payout odds, or
null if no quotes are active.Errors
| Status | Code | Description |
|---|---|---|
| 401 | UNAUTHORIZED | Missing or invalid API key. |
| 403 | FORBIDDEN | You do not own this quote request. |
| 404 | NOT_FOUND | Quote request not found. |
curl https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40 \
-H "X-API-Key: $TOTALIS_API_KEY"
{
"data": {
"quote_request": {
"id": "1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40",
"version": 3,
"request_hash": "sha256:a3f4b2c...",
"book_seq": 5,
"status": "active",
"bet_amount": 25,
"legs": [
{
"id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6",
"event_ticker": "KXBTC-26JUN01",
"market_ticker": "KXBTC-26JUN01-T72500",
"side": "yes",
"venue": "kalshi"
}
],
"input_legs": [
{"market_ticker": "KXBTC-26JUN01-T72500", "side": "yes", "venue": "kalshi"}
],
"expires_at": "2026-06-01T18:45:30.000Z"
},
"quotes": [
{
"id": "b2c3d4e5-6789-0abc-def1-234567890abc",
"market_maker_id": "mm-uuid-1234",
"payout_odds": 4.25,
"user_cost": 25,
"total_payout": 106.25,
"mm_cost": 81.25,
"valid_until": "2026-06-01T18:45:45.000Z",
"leg_prices": [
{"leg_id": "8ccf2c5d-3a61-4707-93f2-b6f0a0f0c0c6", "leg_odds": 0.42}
]
}
],
"best_quote": {
"id": "b2c3d4e5-6789-0abc-def1-234567890abc",
"payout_odds": 4.25,
"user_cost": 25,
"total_payout": 106.25,
"mm_cost": 81.25,
"valid_until": "2026-06-01T18:45:45.000Z"
}
}
}
Was this page helpful?
⌘I