# getRaceResults ## 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 | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ```graphql { "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=" } } } } ``` {% endtab %} {% endtabs %} {% hint style="info" %} Learn how to get your API key here: {% endhint %} ### Available Filters (Query Variables) Query variables used to filter results. {% hint style="info" %} You must apply at least one filter to get results succesfully. {% endhint %} {% tabs %} {% tab title="Distance" %} If you go to you will see results filtered by distance.\ This is the default filter for race results. ```graphql { "first": 2, "input": { "distance": { "from": 1000, "to": 2600 } } } ``` {% endtab %} {% tab title="Location" %} You can filter just by city or country name or both: Filter by city: ```graphql { "first": 2, "input": { "location": { "city": "Katowice" } } } ``` Filter by country: ```graphql { "first": 2, "input": { "location": { "country": "Poland" } } } ``` Filter by both country and city name: ```graphql { "first": 2, "input": { "location": { "country": "Poland", "city": "Katowice" } } } ``` {% endtab %} {% tab title="Dates" %} Dates have to passed in the following format: "YYYY-MM-DD HH:MM:SS" ```graphql { "first": 2, "input": { "dates": { "from": "2020-12-01 00:00:00", "to": "2021-12-01 23:59:00" } } } ``` {% endtab %} {% tab title="Classes" %} Classes: * 0 - Griffin * 1 - Class I * 2 - Class II * 3 - Class III * 4 - Class IV ```graphql { "first": 2, "input": { "classes": [ 1, 2, 3, 4 ] } } ``` You can learn more about classes here:\ {% endtab %} {% tab title="Only My Races" %} This filter requires authentication.\ The token can be copied from **ws\_token** response () ```graphql { "first": 10, "input": { "onlyMyRacehorses": true, "distance": { "from": 1000, "to": 2400 } } } ``` {% endtab %} {% endtabs %} You can freely combine multiple filters to narrow down your results: ```graphql { "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. ```graphql 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: ```graphql 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:
```graphql { "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:
```graphql pageInfo { startCursor endCursor hasNextPage hasPreviousPage } ``` To ilustrate that better, let's narrow down results to a few fields: query variables: ```graphql { "first": 2, "input": { "onlyMyRacehorses": false, "distance": { "from": 1000, "to": 2400 } } } ``` query: ```graphql 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: ```graphql { "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: ```graphql "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. ```graphql "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: ```graphql { "first": 4, "after": "YXJyYXljb25uZWN0aW9uOjE=", "input": { "onlyMyRacehorses": false, "distance": { "from": 1000, "to": 2400 } } } ``` Adding after along with the cursor value: ```graphql "after": "YXJyYXljb25uZWN0aW9uOjE=" ``` tells GraphQL to return the first (4 in our case) races of the next page. ```graphql { "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: ```graphql "cursor": "YXJyYXljb25uZWN0aW9uOjM=", "node": { "city": "Curepipe", "country": "Mauritius" } ``` To traverse back we use "**before**" along with "**last**" param in query variables: ```graphql { "last": 4, "before": "YXJyYXljb25uZWN0aW9uOjM=", "input": { "onlyMyRacehorses": false, "distance": { "from": 1000, "to": 2400 } } } ``` Result: ```graphql { "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:\ We will update our GraphQL schema in the upcoming version, so each field will have its own description there.