Skip to content
Inflection API

Trades

GET
/api/market-data/trades
curl --request GET \
  --url 'https://example.com/api/market-data/trades?market_id=1&limit=100'

One market’s trades, newest first, paged back to its first trade. Past windows too. 503 with Retry-After while a just-closed market’s last trades are still being recorded.

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
market_id
required
Market Id
integer

The market.

limit
Limit
integer
default: 100

Page size, up to 1,000. 100 if not given.

before
Any of:
integer

Only trades with a lower trade_id: the last page’s oldest.

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
Trades
object
market_id
required
Market Id
integer
trades
required
Trades

Newest first.

Array<object>
Trade
object
trade_id
required
Trade Id

Counts 1, 2, 3 within the market.

integer
up_price_bps
required
Up Price Bps

The Up price. The Down price is 10,000 minus it.

integer
quantity
required
Quantity

Lots.

integer
taker_outcome
required
Taker Outcome

The outcome of the order that took liquidity.

string
Allowed values: up down
taker_side
required
Taker Side

Whether that order bought or sold its outcome.

string
Allowed values: buy sell
time_ms
required
Time Ms
integer
reversed
required
Reversed

True once the vault skipped the trade and the exchange took it back from both sides, which can be some time after it traded. It stays on the tape.

boolean
reversed_reason
required
Any of:
string
Example
{
  "trades": [
    {
      "taker_outcome": "up",
      "taker_side": "buy"
    }
  ]
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}