Quick Start

Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error. You can request API key by filling out a form here

Make your first request

To make your first request, send an authenticated request to the pets endpoint. This will return a list of the latest race results.

Get list of finished races.

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

Retrieves a list of all currently open races. Returns 10 results

Headers

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

Request Body

Name	Type	Description
tier	Number	Tier ID of requested races. Defaults to 5 (omega)
offset	Number	Number of entries to skip. Defaults to 0

200 Data returned

[
    {
        "main_race_id": 129864,
        "start_time": 1669047660000,
        "registration_deadline": 1669047360000,
        "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,
        "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

Take a look at how you might call this method using our official libraries, or via curl:

curl

curl https://api.derace.com/api/v1/races/open  
    -H 'x-api-key: API_KEY'