Get order match events

Prod Env

https://api.predict.fun

GET

/v1/orders/matches

Get a paginated list of order match events with optional filtering by category, market, minimum value and signer. The results are sorted by executedAt DESC.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Responses

🟢200

application/json

Response 200

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.predict.fun/v1/orders/matches?first&after&categoryId&marketId&minValueUsdtWei&signerAddress&isSignerMaker' \
--header 'x-api-key: <api-key>'

Response Example

{
    "success": true,
    "cursor": "string",
    "data": [
        {
            "market": {
                "id": 0,
                "imageUrl": "string",
                "title": "string",
                "question": "string",
                "description": "string",
                "status": "REGISTERED",
                "isNegRisk": true,
                "isYieldBearing": true,
                "feeRateBps": 0,
                "resolution": {
                    "name": "string",
                    "indexSet": 0,
                    "onChainId": "string",
                    "status": "WON"
                },
                "oracleQuestionId": "string",
                "conditionId": "string",
                "resolverAddress": "string",
                "outcomes": [
                    {
                        "name": "string",
                        "indexSet": 0,
                        "onChainId": "string",
                        "status": "WON"
                    }
                ],
                "questionIndex": 0,
                "spreadThreshold": 0,
                "shareThreshold": 0,
                "isBoosted": true,
                "boostStartsAt": "string",
                "boostEndsAt": "string",
                "polymarketConditionIds": [
                    "string"
                ],
                "kalshiMarketTicker": "string",
                "categorySlug": "string",
                "createdAt": "string",
                "decimalPrecision": 2,
                "marketVariant": "DEFAULT",
                "variantData": {
                    "type": "CRYPTO_UP_DOWN",
                    "startPrice": 0,
                    "endPrice": 0,
                    "priceFeedId": "string"
                }
            },
            "taker": {
                "quoteType": "Ask",
                "amount": "string",
                "price": "string",
                "outcome": {
                    "name": "string",
                    "indexSet": 0,
                    "onChainId": "string",
                    "status": "WON"
                },
                "signer": "string",
                "fee": {
                    "amount": "string",
                    "type": "COLLATERAL"
                }
            },
            "amountFilled": "string",
            "priceExecuted": "string",
            "makers": [
                {
                    "quoteType": "Ask",
                    "amount": "string",
                    "price": "string",
                    "outcome": {
                        "name": "string",
                        "indexSet": 0,
                        "onChainId": "string",
                        "status": "WON"
                    },
                    "signer": "string",
                    "fee": {
                        "amount": "string",
                        "type": "COLLATERAL"
                    }
                }
            ],
            "transactionHash": "string",
            "executedAt": "string"
        }
    ]
}

Modified at 2026-01-31 16:05:09

Get orders

Create an order