Races

Race actions

Get list of finished races.

GET https://api.derace.com/api/v2/races/results

Retrieves a list of latest finished races. Returns 10 results

Headers

Name	Type	Description
x-api-key*	String	App's API key
content-type*	String	application/json

Request Body

Name	Type	Description
tier	Number	Tier ID of requested races. Defaults to 5 (Omega)
start_time_from	Number	Start time to look for races from. Results will not include race if it starts at this exact time. Defaults to time of search

200 Data returned

[
    {
        "main_race_id": 129864,
        "start_time": 1669047660000,
        "registration_deadline": 1669047360000,
        "type": "best_time", /* alternatively "worst_time" */
        "length": 6,
        "v2": true,
        "no_equipment": false,
        "entry_fee": 2000000000000000000,
        "prizes": [
            50,
            30,
            15
        ],
        "tier": "Omega",
        "info": {
            "name": "Omega Race #129864",
            "hippodrome_type": "sakura",
            "hippodrome_name": "Sakura Path",
            "turf": "Turf"
        },
        "places": 12,
        "min_level": 1,
        "max_level": 80,
        "participants": [
            {
                "number": 821,
                "total": 72646,
                "lane": 1
            },
            {
                "number": 831,
                "total": 73699,
                "lane": 2
            },
            {
                "number": 817,
                "total": 73919,
                "lane": 3
            },
            {
                "number": 839,
                "total": 76073,
                "lane": 4
            },
            {
                "number": 844,
                "total": 74200,
                "lane": 5
            },
            {
                "number": 840,
                "total": 75379,
                "lane": 6
            }
        ],
        "status": "",
        "final_order": [
            0,
            1,
            2,
            4,
            5,
            3
        ],
        "winners": [
            0,
            1,
            2
        ]
    }
]

401 Permission denied

Get list of open races.

GET https://api.derace.com/api/v1/races/open

Retrieves a list of all currently open races.

Headers

Name	Type	Description
x-api-key*	String	App's API key
content-type*		application/json

200 Data returned

[
    {
        "_id": "pAbgW33LsoqL9sFQu",
        "main_race_id": 131624,
        "start_time": 1669737900000,
        "registration_deadline": 1669737600000,
        "type": "best_time", /* alternatively "worst_time" */
        "length": 6,
        "v2": true,
        "no_equipment": false,
        "entry_fee": 30000000000000000000,
        "prizes": [
            50,
            30,
            15
        ],
        "tier": "Omega",
        "info": {
            "name": "High Roller Race #131624",
            "hippodrome_type": "sakura",
            "hippodrome_name": "Sakura Path",
            "turf": "Turf"
        },
        "places": 12,
        "participants": [],
        "status": "In progress",
        "min_level": 1,
        "max_level": 80,
    }
]

401 Permission denied

Get information about a specific race

GET https://api.derace.com/api/v1/races/:raceId

Pass race id and retrieve information about that race

Query Parameters

Name	Type	Description
raceId*	Number

Headers

Name	Type	Description
x-api-key*	String	App's API key
content-type*		application/json

200 Data returned

[
    {
        "_id": "pAbgW33LsoqL9sFQu",
        "main_race_id": 131624,
        "start_time": 1669737900000,
        "registration_deadline": 1669737600000,
        "type": "best_time", /* alternatively "worst_time" */
        "length": 6,
        "v2": true,
        "no_equipment": false,
        "entry_fee": 30000000000000000000,
        "prizes": [
            50,
            30,
            15
        ],
        "tier": "Omega",
        "info": {
            "name": "High Roller Race #131624",
            "hippodrome_type": "sakura",
            "hippodrome_name": "Sakura Path",
            "turf": "Turf"
        },
        "places": 12,
        "participants": [],
        "status": "In progress",
        "min_level": 1,
        "max_level": 80,
    }
]

401 Permission denied

Register horse to a race

POST https://api.derace.com/api/v1/races/register

Attempts to register a selected horse into the selected race

Headers

Name	Type	Description
x-api-key*	String	App's API key
content-type*	String	application/json

Request Body

Name	Type	Description
horse_number*	Number	Number of horse asset
user_key*	String	API Key of the user (horse owner)
main_race_id*	Number	Main race id of the designated race

200 Registration successful

401 Permission denied

403: Forbidden Access forbidden. Returned if user_key is invalid

400: Bad Request Request errored out with an error code

- user_withdraw_lock - user's account is on a participation lock;
- invalid_horse - horse cannot be found;
- horse_on_cooldown - horse on race cooldown
- horse_already_registered - horse already registered in another pending race;
- race_invalid - race cannot be found;
- insufficient_balance - user does not have enough to participate in this race;
- race_full - race full;