getRaceResults

GraphQL query to display race results.

getRaceResults

POST https://zed-ql.zed.run/graphql

This endpoint allows you to get race results filtered by: • location (country, city) • dates (from, to) • distance (from, to) • classes • boolean flag onlyMyRacehorses

Headers

Name	Type	Description
x-developer-secret	string	Please see the link below.
Content-Type	string	application/json

200 Cake successfully retrieved.

{
  "data": {
    "getRaceResults": {
      "edges": [
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjA=",
          "node": {
            "city": "Perugia",
            "class": 2,
            "country": "Italy",
            "fee": "0.0",
            "horses": [
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 2,
                "coat": "Chartreuse",
                "finalPosition": "9",
                "finishTime": 107.664,
                "gate": "8",
                "gen": "Z10",
                "gender": "Colt",
                "hexColor": "7FFF00",
                "horseId": 9609,
                "imgUrl": "https://img.zed.run/horses/7FFF00.svg",
                "name": "Crazy Dream",
                "ownerAddress": "0x958Ea35817C7cfbb216174486800dFA8F3024BE7",
                "stableName": "Aloha Racing"
              },
              {
                "bloodline": "Szabo",
                "breedType": "legendary",
                "class": 3,
                "coat": "Oval Orchid",
                "finalPosition": "3",
                "finishTime": 106.692,
                "gate": "12",
                "gen": "Z8",
                "gender": "Mare",
                "hexColor": "DA70D6",
                "horseId": 6670,
                "imgUrl": "https://img.zed.run/horses/DA70D6.svg",
                "name": "Tiger_Roll",
                "ownerAddress": "0x0680cC6a4d7F7b9A3c3f584eF2d5DF04d6931c32",
                "stableName": "₿ Moon Mission"
              },
              {
                "bloodline": "Nakamoto",
                "breedType": "exclusive",
                "class": 3,
                "coat": "Electric Violet",
                "finalPosition": "8",
                "finishTime": 107.3864,
                "gate": "9",
                "gen": "Z3",
                "gender": "Filly",
                "hexColor": "8F00FF",
                "horseId": 8319,
                "imgUrl": "https://img.zed.run/horses/8F00FF.svg",
                "name": "Sky Lynx",
                "ownerAddress": "0x260747CEFB9453F0c48fc36cee216EA996b82F94",
                "stableName": "Secure Digital"
              },
              {
                "bloodline": "Nakamoto",
                "breedType": "exclusive",
                "class": 2,
                "coat": "Ghost White",
                "finalPosition": "7",
                "finishTime": 107.2254,
                "gate": "3",
                "gen": "Z3",
                "gender": "Mare",
                "hexColor": "FFFFFF",
                "horseId": 6533,
                "imgUrl": "https://img.zed.run/horses/FFFFFF.svg",
                "name": "Blitzkrieg",
                "ownerAddress": "0xE966C1E81B70920293C123C81994ef5fc19f8D35",
                "stableName": "KUDA STABLE"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 5,
                "coat": "Rosy Brown",
                "finalPosition": "5",
                "finishTime": 107.0768,
                "gate": "6",
                "gen": "Z9",
                "gender": "Filly",
                "hexColor": "BC8F8F",
                "horseId": 4026,
                "imgUrl": "https://img.zed.run/horses/BC8F8F.svg",
                "name": "Terrazzo",
                "ownerAddress": "0x5697336651A2Caf8A4772301aaF19cd93d0511BE",
                "stableName": "Lady Boss"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 4,
                "coat": "Alabaster",
                "finalPosition": "10",
                "finishTime": 107.6694,
                "gate": "11",
                "gen": "Z10",
                "gender": "Colt",
                "hexColor": "F2F0E6",
                "horseId": 11709,
                "imgUrl": "https://img.zed.run/horses/F2F0E6.svg",
                "name": "Come By Chance",
                "ownerAddress": "0x3ED70d502D9feb8be9d2e4bd8713d4F55E6DC2Ef",
                "stableName": "Aux noms d'Or"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 3,
                "coat": "Azure",
                "finalPosition": "6",
                "finishTime": 107.2243,
                "gate": "10",
                "gen": "Z10",
                "gender": "Filly",
                "hexColor": "007FFF",
                "horseId": 11007,
                "imgUrl": "https://img.zed.run/horses/007FFF.svg",
                "name": "Marital",
                "ownerAddress": "0x157b1c8C3De55B87be545B3DBc9D17f06F0112F8",
                "stableName": "Totoshe"
              },
              {
                "bloodline": "Finney",
                "breedType": "genesis",
                "class": 2,
                "coat": "Space Sparkle",
                "finalPosition": "1",
                "finishTime": 105.9995,
                "gate": "1",
                "gen": "Z6",
                "gender": "Colt",
                "hexColor": "4A646C",
                "horseId": 10924,
                "imgUrl": "https://img.zed.run/horses/4A646C.svg",
                "name": "Hunters Madness",
                "ownerAddress": "0x8A5AFB1233f7aFe089EfDCC8F5538d6753e26ad9",
                "stableName": "Shadow Stable"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 5,
                "coat": "Pale Violet",
                "finalPosition": "12",
                "finishTime": 107.7833,
                "gate": "2",
                "gen": "Z9",
                "gender": "Colt",
                "hexColor": "DB7093",
                "horseId": 11157,
                "imgUrl": "https://img.zed.run/horses/DB7093.svg",
                "name": "Wild Naturally",
                "ownerAddress": "0x11d199eDA53173A9055C3DA86f45CB78e6106440",
                "stableName": "Make$It$Rain"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 4,
                "coat": "Champagne Papi",
                "finalPosition": "4",
                "finishTime": 106.9278,
                "gate": "5",
                "gen": "Z10",
                "gender": "Filly",
                "hexColor": "F1DDCF",
                "horseId": 10649,
                "imgUrl": "https://img.zed.run/horses/F1DDCF.svg",
                "name": "Boss In The Game",
                "ownerAddress": "0x08a3a8Ea83198dEceAd437c4077789b340D07032",
                "stableName": "Dratini"
              },
              {
                "bloodline": "Szabo",
                "breedType": "legendary",
                "class": 1,
                "coat": "Fandango",
                "finalPosition": "2",
                "finishTime": 106.681,
                "gate": "7",
                "gen": "Z5",
                "gender": "Stallion",
                "hexColor": "B53389",
                "horseId": 11146,
                "imgUrl": "https://img.zed.run/horses/B53389.svg",
                "name": "I'm A Ducky On The Edge",
                "ownerAddress": "0x8ddC79980651c394400D5E8A4112868A2ec522bb",
                "stableName": "Doofy Racing"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 5,
                "coat": "Dark Byzantium",
                "finalPosition": "11",
                "finishTime": 107.778,
                "gate": "4",
                "gen": "Z10",
                "gender": "Colt",
                "hexColor": "5D3954",
                "horseId": 11658,
                "imgUrl": "https://img.zed.run/horses/5D3954.svg",
                "name": "Times Square",
                "ownerAddress": "0x931C9818A8d84fA031bb6F65A244280C45121085",
                "stableName": "Morning Dew Stables"
              }
            ],
            "length": 1800,
            "name": "Italian Guineas",
            "prizePool": {
              "first": "1680000000000000",
              "second": "700000000000000",
              "third": "420000000000000"
            },
            "raceId": "J57gYqMi",
            "startTime": "2021-02-16T02:20:00",
            "status": "finished",
            "weather": "Sunny"
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjE=",
          "node": {
            "city": "Olinda",
            "class": 5,
            "country": "Brazil",
            "fee": "0.0",
            "horses": [
              {
                "bloodline": "Buterin",
                "breedType": "pacer",
                "class": 5,
                "coat": "Absolute Zero",
                "finalPosition": "9",
                "finishTime": 146.6228,
                "gate": "2",
                "gen": "Z45",
                "gender": "Colt",
                "hexColor": "0048BA",
                "horseId": 8241,
                "imgUrl": "https://img.zed.run/horses/0048BA.svg",
                "name": "BlueStreak",
                "ownerAddress": "0x260747CEFB9453F0c48fc36cee216EA996b82F94",
                "stableName": "Secure Digital"
              },
              {
                "bloodline": "Buterin",
                "breedType": "legendary",
                "class": 5,
                "coat": "Absolute Zero",
                "finalPosition": "1",
                "finishTime": 143.0366,
                "gate": "8",
                "gen": "Z18",
                "gender": "Colt",
                "hexColor": "0048BA",
                "horseId": 9800,
                "imgUrl": "https://img.zed.run/horses/0048BA.svg",
                "name": "Dodge",
                "ownerAddress": "0x28FC104755Cee05cB1B62C8385d105D692B5563E",
                "stableName": "SLONGS"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 5,
                "coat": "Big Dip O’Ruby",
                "finalPosition": "11",
                "finishTime": 147.0784,
                "gate": "7",
                "gen": "Z9",
                "gender": "Colt",
                "hexColor": "9C2542",
                "horseId": 10870,
                "imgUrl": "https://img.zed.run/horses/9C2542.svg",
                "name": "Casual Smile",
                "ownerAddress": "0x08a3a8Ea83198dEceAd437c4077789b340D07032",
                "stableName": "Dratini"
              },
              {
                "bloodline": "Buterin",
                "breedType": "pacer",
                "class": 5,
                "coat": "Bittersweet Shimmer",
                "finalPosition": "12",
                "finishTime": 148.2224,
                "gate": "5",
                "gen": "Z56",
                "gender": "Colt",
                "hexColor": "BF4F51",
                "horseId": 10253,
                "imgUrl": "https://img.zed.run/horses/BF4F51.svg",
                "name": "Proverbs'",
                "ownerAddress": "0x96D286D6280455EDe2A2ca412D4ba796AB5e5156",
                "stableName": "⚛ϓϊρɦ₸âçĥ 🏆 Ŕãçϊɳĝ*"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 5,
                "coat": "Copper Penny",
                "finalPosition": "3",
                "finishTime": 144.9608,
                "gate": "10",
                "gen": "Z9",
                "gender": "Filly",
                "hexColor": "AD6F69",
                "horseId": 11395,
                "imgUrl": "https://img.zed.run/horses/AD6F69.svg",
                "name": "Sword of Art",
                "ownerAddress": "0xeA2765E6E0d3e27f7D7ebe52b1fd3E9f6C5be8C1",
                "stableName": "Emerald Ranch"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 5,
                "coat": "Champagne Papi",
                "finalPosition": "4",
                "finishTime": 145.1731,
                "gate": "1",
                "gen": "Z10",
                "gender": "Colt",
                "hexColor": "F1DDCF",
                "horseId": 11194,
                "imgUrl": "https://img.zed.run/horses/F1DDCF.svg",
                "name": "Bro Code",
                "ownerAddress": "0x11d199eDA53173A9055C3DA86f45CB78e6106440",
                "stableName": "Make$It$Rain"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 5,
                "coat": "Burnt Sienna",
                "finalPosition": "8",
                "finishTime": 146.5508,
                "gate": "12",
                "gen": "Z9",
                "gender": "Colt",
                "hexColor": "E97451",
                "horseId": 10570,
                "imgUrl": "https://img.zed.run/horses/E97451.svg",
                "name": "Smooth Boss",
                "ownerAddress": "0x0680cC6a4d7F7b9A3c3f584eF2d5DF04d6931c32",
                "stableName": "₿ Moon Mission"
              },
              {
                "bloodline": "Buterin",
                "breedType": "elite",
                "class": 5,
                "coat": "Cinereous",
                "finalPosition": "7",
                "finishTime": 146.2491,
                "gate": "9",
                "gen": "Z24",
                "gender": "Filly",
                "hexColor": "98817B",
                "horseId": 7245,
                "imgUrl": "https://img.zed.run/horses/98817B.svg",
                "name": "Bugs Bunny",
                "ownerAddress": "0x26dC85D85c7249ea9449020A7109A28f599b1746",
                "stableName": "⇜ÐΛ℟₭ F҉ Ï℟€ Λ₵℟€Ꮥ⇝"
              },
              {
                "bloodline": "Buterin",
                "breedType": "legendary",
                "class": 5,
                "coat": "Firebrick",
                "finalPosition": "2",
                "finishTime": 144.1881,
                "gate": "11",
                "gen": "Z12",
                "gender": "Colt",
                "hexColor": "B22222",
                "horseId": 10821,
                "imgUrl": "https://img.zed.run/horses/B22222.svg",
                "name": "The Trouble Maker",
                "ownerAddress": "0xE966C1E81B70920293C123C81994ef5fc19f8D35",
                "stableName": "KUDA STABLE"
              },
              {
                "bloodline": "Buterin",
                "breedType": "genesis",
                "class": 5,
                "coat": "Cyclamen",
                "finalPosition": "5",
                "finishTime": 145.4186,
                "gate": "4",
                "gen": "Z10",
                "gender": "Colt",
                "hexColor": "F56FA1",
                "horseId": 11234,
                "imgUrl": "https://img.zed.run/horses/F56FA1.svg",
                "name": "Excellent Rhythm",
                "ownerAddress": "0x65037Ca39E04fC61928d3FdAf2F65E4DfBbc8C42",
                "stableName": "Stable Jenius"
              },
              {
                "bloodline": "Buterin",
                "breedType": "legendary",
                "class": 5,
                "coat": "Big Dip O’Ruby",
                "finalPosition": "6",
                "finishTime": 145.5193,
                "gate": "3",
                "gen": "Z16",
                "gender": "Colt",
                "hexColor": "9C2542",
                "horseId": 10548,
                "imgUrl": "https://img.zed.run/horses/9C2542.svg",
                "name": "Sargent Pepper",
                "ownerAddress": "0xB2580Eb6f0d504289E527d4Ac6eC04F134077431",
                "stableName": "Rohan's Finest"
              },
              {
                "bloodline": "Nakamoto",
                "breedType": "exclusive",
                "class": 5,
                "coat": "Midnight Black",
                "finalPosition": "10",
                "finishTime": 147.0546,
                "gate": "6",
                "gen": "Z6",
                "gender": "Colt",
                "hexColor": "000000",
                "horseId": 8644,
                "imgUrl": "https://img.zed.run/horses/000000.svg",
                "name": "Tenkamenin",
                "ownerAddress": "0x66B2FBfc3c016aAF66AFb9B3fDAAbb299b2d6b93",
                "stableName": "Dream Stable"
              }
            ],
            "length": 2400,
            "name": "Grande Prêmio Olinda",
            "prizePool": {
              "first": "840000000000000",
              "second": "350000000000000",
              "third": "210000000000000"
            },
            "raceId": "8nAhB68",
            "startTime": "2021-02-16T02:16:00",
            "status": "finished",
            "weather": "Sunny"
          }
        }
      ],
      "pageInfo": {
        "endCursor": "YXJyYXljb25uZWN0aW9uOjE=",
        "hasNextPage": true,
        "hasPreviousPage": false,
        "startCursor": "YXJyYXljb25uZWN0aW9uOjA="
      }
    }
  }
}

Learn how to get your API key here: https://docs.zed.run/getting-started/api-keys

Available Filters (Query Variables)

Query variables used to filter results.

You must apply at least one filter to get results succesfully.

Distance

If you go to https://zed.run/racing/results you will see results filtered by distance. This is the default filter for race results.

{
	"first": 2,
	"input": {
		"distance": {
			"from": 1000,
			"to": 2600
		}
	}
}

Location

Dates

Classes

Only My Races

You can freely combine multiple filters to narrow down your results:

{
	"first": 2,
	"input": {
		"onlyMyRacehorses": false,
		"location": {
			"country": "Poland",
			"city": "Katowice"
		},
		"dates": {
			"from": "2020-12-01 00:00:00",
			"to": "2021-12-01 23:59:00"
		},
		"distance": {
			"from": 1000,
			"to": 2400
		},
		"classes": [
			1,
			2,
			3,
			4
		]
	}
}

Request Body (GraphQL Query)

The second part of our GraphQL request requires the actual body that also can be used to display results that are only neccecary / interested for us.

query ($input: GetRaceResultsInput, $before: String, $after: String, $first: Int, $last: Int) {
  getRaceResults(before: $before, after: $after, first: $first, last: $last, input: $input) {
    edges {
      cursor
      node {
        country
        city
        name
        length
        startTime
        fee
        raceId
        weather
        status
        class
        prizePool {
          first
          second
          third
        }
        horses {
          horseId
          finishTime
          finalPosition
          name
          gate
          ownerAddress
          bloodline
          gender
          breedType
          gen
          coat
          hexColor
          imgUrl
          class
          stableName
        }
      }
    }
    pageInfo {
      startCursor
      endCursor
      hasNextPage
      hasPreviousPage
    }
  }
}

One of the benefits of GraphQL is the ability to select only specific fields we want to see in our results. Let's say we want to get only names of the horses, the first prize from the pool and country name:

query ($input: GetRaceResultsInput, $before: String, $after: String, $first: Int, $last: Int) {
  getRaceResults(before: $before, after: $after, first: $first, last: $last, input: $input) {
    edges {
      cursor
      node {
        country
        prizePool {
          first
        }
        horses {
          name
        }
      }
    }
    pageInfo {
      startCursor
      endCursor
      hasNextPage
      hasPreviousPage
    }
  }
}

Go ahead and experiment with different variations of the results.

Pagination

You probably noticed that I used "first": 2 in the query variables:

{
	"first": 2,
	"input": {
		"distance": {
			"from": 1000,
			"to": 2600
		}
	}
}

This controls the number of results per page and does not have to be "2", can be any other positive integer value but how can I get to the next result?

This part of the query returns all we need to know if we can traverse through the pages:

    pageInfo {
      startCursor
      endCursor
      hasNextPage
      hasPreviousPage
    }

To ilustrate that better, let's narrow down results to a few fields:

query variables:

{
	"first": 2,
	"input": {
		"onlyMyRacehorses": false,
		"distance": {
			"from": 1000,
			"to": 2400
		}
	}
}

query:

query ($input: GetRaceResultsInput, $before: String, $after: String, $first: Int, $last: Int) {
  getRaceResults(before: $before, after: $after, first: $first, last: $last, input: $input) {
    edges {
      cursor
      node {
        country
        city
      }
    }
    pageInfo {
      startCursor
      endCursor
      hasNextPage
      hasPreviousPage
    }
  }
}

And here's a sample result:

{
  "data": {
    "getRaceResults": {
      "edges": [
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjA=",
          "node": {
            "city": "Hamburg",
            "country": "Germany"
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjE=",
          "node": {
            "city": "Prague",
            "country": "Czech Republic"
          }
        }
      ],
      "pageInfo": {
        "endCursor": "YXJyYXljb25uZWN0aW9uOjE=",
        "hasNextPage": true,
        "hasPreviousPage": false,
        "startCursor": "YXJyYXljb25uZWN0aW9uOjA="
      }
    }
  }
}

Notice that endCursor is the same as the cursor of the last edge (the one with Prague) and startCursor is the same as the first edge (Hamburg).

As you can see each edge has a cursor assigned:

"edges": [
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjA=",

and pageInfo tells us if we have the next page, the previous one (always false for the very first page) and provides cursors (think about them as bookmarks) for the next pages with the results.

      "pageInfo": {
        "endCursor": "YXJyYXljb25uZWN0aW9uOjE=",
        "hasNextPage": true,
        "hasPreviousPage": false,
        "startCursor": "YXJyYXljb25uZWN0aW9uOjA="
      }

Having cursor assigned to a concrete edge, allows us to display results before or after the concrete edge. This is a way more flexible then traditional pagination method and much more mobile friendly.

And here's how we pass cursors to the query:

{
	"first": 4,
  "after": "YXJyYXljb25uZWN0aW9uOjE=",
	"input": {
		"onlyMyRacehorses": false,
		"distance": {
			"from": 1000,
			"to": 2400
		}
	}
}

Adding after along with the cursor value:

"after": "YXJyYXljb25uZWN0aW9uOjE="

tells GraphQL to return the first (4 in our case) races of the next page.

{
  "data": {
    "getRaceResults": {
      "edges": [
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjI=",
          "node": {
            "city": "Stockholm",
            "country": "Sweden"
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjM=",
          "node": {
            "city": "Curepipe",
            "country": "Mauritius"
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjQ=",
          "node": {
            "city": "Lahore",
            "country": "Pakistan"
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjU=",
          "node": {
            "city": "Stockholm",
            "country": "Sweden"
          }
        }
      ],
      "pageInfo": {
        "endCursor": "YXJyYXljb25uZWN0aW9uOjU=",
        "hasNextPage": true,
        "hasPreviousPage": true,
        "startCursor": "YXJyYXljb25uZWN0aW9uOjI="
      }
    }
  }
}

Now you see that both hasNextPage nad hasPreviousPage are true, it means we have some races on the prevoius page and we can go back, let's try.

Display 3 races before the race in Mauritius. Let's check the cursor of that race:

          "cursor": "YXJyYXljb25uZWN0aW9uOjM=",
          "node": {
            "city": "Curepipe",
            "country": "Mauritius"
          }

To traverse back we use "before" along with "last" param in query variables:

{
	"last": 4,
  "before": "YXJyYXljb25uZWN0aW9uOjM=",
	"input": {
		"onlyMyRacehorses": false,
		"distance": {
			"from": 1000,
			"to": 2400
		}
	}
}

Result:

{
  "data": {
    "getRaceResults": {
      "edges": [
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjA=",
          "node": {
            "city": "Hamburg",
            "country": "Germany"
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjE=",
          "node": {
            "city": "Prague",
            "country": "Czech Republic"
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjI=",
          "node": {
            "city": "Stockholm",
            "country": "Sweden"
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uOjM=",
          "node": {
            "city": "Curepipe",
            "country": "Mauritius"
          }
        }
      ],
      "pageInfo": {
        "endCursor": "YXJyYXljb25uZWN0aW9uOjM=",
        "hasNextPage": true,
        "hasPreviousPage": false,
        "startCursor": "YXJyYXljb25uZWN0aW9uOjA="
      }
    }
  }
}

More about GraphQL pagination can be found in the official documentation: https://graphql.org/learn/pagination/

We will update our GraphQL schema in the upcoming version, so each field will have its own description there.