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:46:30.000Z"
},
"quotes": [
{
"id": "b2c3d4e5-6789-0abc-def1-234567890abc",
"market_maker_id": "did:privy:cm3mm...",
"payout_odds": 4.0,
"user_cost": 24.75,
"total_payout": 99,
"mm_cost": 74.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.0,
"user_cost": 24.75,
"total_payout": 99,
"mm_cost": 74.25,
"valid_until": "2026-06-01T18:45:45.000Z"
}
}
}
Quote service
Get quote request
Retrieve a quote request with its 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:46:30.000Z"
},
"quotes": [
{
"id": "b2c3d4e5-6789-0abc-def1-234567890abc",
"market_maker_id": "did:privy:cm3mm...",
"payout_odds": 4.0,
"user_cost": 24.75,
"total_payout": 99,
"mm_cost": 74.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.0,
"user_cost": 24.75,
"total_payout": 99,
"mm_cost": 74.25,
"valid_until": "2026-06-01T18:45:45.000Z"
}
}
}
Retrieve a quote request by ID. You get the request, every active quote for its current version, and the best quote (highest payout odds). For live updates, open the SSE stream instead.
A Privy JWT (
Authentication
Send 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, 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 applied to
user_cost.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:46:30.000Z"
},
"quotes": [
{
"id": "b2c3d4e5-6789-0abc-def1-234567890abc",
"market_maker_id": "did:privy:cm3mm...",
"payout_odds": 4.0,
"user_cost": 24.75,
"total_payout": 99,
"mm_cost": 74.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.0,
"user_cost": 24.75,
"total_payout": 99,
"mm_cost": 74.25,
"valid_until": "2026-06-01T18:45:45.000Z"
}
}
}
Was this page helpful?