General guidelines

• Please use this API responsibly. If you want to know the price of ALL ITEMS and are considering making a request for every single item please, please, please use the 'persist=no' query parameter. You can tell this works by the fact that the "id" field will no longer show in the result.
• Please add a "User-Agent" HTTP header that identifies your tool, service, etc. I will block clients that don't identify themselves enough for me to reach them if they are doing something that's abusive.
• If you have any questions with this where the limits are, contact me. See the bottom of the about page to see how you can get ahold of me.

Get an Appraisal GET /a/[appraisal-id].json

This endpoint returns the details for an appraisal in JSON format. The data includes everything needed to render the appraisal page. The most important part of the response is in the "totals" top-level key which includes the total buy price and sell price.

CURL Example

curl "https://appraise.imperium.nexus/a/coyaw.json"

{
    "created": 1505592961,
    "id": "coyaw",
    "items": [
        {
            "meta": {
                "bpc": false
            },
            "name": "avatar",
            "prices": {
                "all": {
                    "avg": 0,
                    "max": 64840457150.95,
                    "median": 64840457150.95,
                    "min": 64840457150.95,
                    "order_count": 0,
                    "percentile": 64840457150.95,
                    "stddev": 0,
                    "volume": 0
                },
                "buy": {
                    "avg": 0,
                    "max": 64840457150.95,
                    "median": 64840457150.95,
                    "min": 64840457150.95,
                    "order_count": 0,
                    "percentile": 64840457150.95,
                    "stddev": 0,
                    "volume": 0
                },
                "sell": {
                    "avg": 0,
                    "max": 64840457150.95,
                    "median": 64840457150.95,
                    "min": 64840457150.95,
                    "order_count": 0,
                    "percentile": 64840457150.95,
                    "stddev": 0,
                    "volume": 0
                },
                "strategy": "ccp",
                "updated": "2017-09-16T20:12:25.615722552Z"
            },
            "quantity": 1,
            "typeID": 11567,
            "typeName": "Avatar",
            "typeVolume": 10000000
        }
    ],
    "kind": "listing",
    "market_name": "jita",
    "raw": "avatar",
    "totals": {
        "buy": 64840457150.95,
        "sell": 64840457150.95,
        "volume": 10000000
    },
    "unparsed": {}
}

Create Appraisal POST /appraisal.json

This enpoint creates a new appraisal.

CURL Example (without persisting)

curl -XPOST "https://appraise.imperium.nexus/appraisal.json?market=jita&raw_textarea=avatar&persist=no"

{
    "appraisal": {
        "created": 1505593417,
        "items": [
            {
                "meta": {
                    "bpc": false
                },
                "name": "avatar",
                "prices": {
                    "all": {
                        "avg": 0,
                        "max": 64840457150.95,
                        "median": 64840457150.95,
                        "min": 64840457150.95,
                        "order_count": 0,
                        "percentile": 64840457150.95,
                        "stddev": 0,
                        "volume": 0
                    },
                    "buy": {
                        "avg": 0,
                        "max": 64840457150.95,
                        "median": 64840457150.95,
                        "min": 64840457150.95,
                        "order_count": 0,
                        "percentile": 64840457150.95,
                        "stddev": 0,
                        "volume": 0
                    },
                    "sell": {
                        "avg": 0,
                        "max": 64840457150.95,
                        "median": 64840457150.95,
                        "min": 64840457150.95,
                        "order_count": 0,
                        "percentile": 64840457150.95,
                        "stddev": 0,
                        "volume": 0
                    },
                    "strategy": "ccp",
                    "updated": "2017-09-16T20:22:26.885313357Z"
                },
                "quantity": 1,
                "typeID": 11567,
                "typeName": "Avatar",
                "typeVolume": 10000000
            }
        ],
        "kind": "listing",
        "market_name": "jita",
        "raw": "avatar",
        "totals": {
            "buy": 64840457150.95,
            "sell": 64840457150.95,
            "volume": 10000000
        },
        "unparsed": {}
    }
}

CURL Example (with persisting)

curl -XPOST "https://appraise.imperium.nexus/appraisal.json?market=jita&raw_textarea=avatar"

{
    "appraisal": {
        "created": 1505593417,
        "id": "coyfr",
        "items": [
            {
                "meta": {
                    "bpc": false
                },
                "name": "avatar",
                "prices": {
                    "all": {
                        "avg": 0,
                        "max": 64840457150.95,
                        "median": 64840457150.95,
                        "min": 64840457150.95,
                        "order_count": 0,
                        "percentile": 64840457150.95,
                        "stddev": 0,
                        "volume": 0
                    },
                    "buy": {
                        "avg": 0,
                        "max": 64840457150.95,
                        "median": 64840457150.95,
                        "min": 64840457150.95,
                        "order_count": 0,
                        "percentile": 64840457150.95,
                        "stddev": 0,
                        "volume": 0
                    },
                    "sell": {
                        "avg": 0,
                        "max": 64840457150.95,
                        "median": 64840457150.95,
                        "min": 64840457150.95,
                        "order_count": 0,
                        "percentile": 64840457150.95,
                        "stddev": 0,
                        "volume": 0
                    },
                    "strategy": "ccp",
                    "updated": "2017-09-16T20:22:26.885313357Z"
                },
                "quantity": 1,
                "typeID": 11567,
                "typeName": "Avatar",
                "typeVolume": 10000000
            }
        ],
        "kind": "listing",
        "market_name": "jita",
        "raw": "avatar",
        "totals": {
            "buy": 64840457150.95,
            "sell": 64840457150.95,
            "volume": 10000000
        },
        "unparsed": {}
    }
}

CURL Example using POST data

curl -v "https://appraise.imperium.nexus/appraisal.json?market=jita" --data "avatar"

{
    "appraisal": {
        "created": 1505593448,
        "id": "coyg5",
        "items": [
            {
                "meta": {
                    "bpc": false
                },
                "name": "Erebus",
                "prices": {
                    "all": {
                        "avg": 0,
                        "max": 73105235239.37,
                        "median": 73105235239.37,
                        "min": 73105235239.37,
                        "order_count": 0,
                        "percentile": 73105235239.37,
                        "stddev": 0,
                        "volume": 0
                    },
                    "buy": {
                        "avg": 0,
                        "max": 73105235239.37,
                        "median": 73105235239.37,
                        "min": 73105235239.37,
                        "order_count": 0,
                        "percentile": 73105235239.37,
                        "stddev": 0,
                        "volume": 0
                    },
                    "sell": {
                        "avg": 0,
                        "max": 73105235239.37,
                        "median": 73105235239.37,
                        "min": 73105235239.37,
                        "order_count": 0,
                        "percentile": 73105235239.37,
                        "stddev": 0,
                        "volume": 0
                    },
                    "strategy": "ccp",
                    "updated": "2017-09-16T20:22:26.885313357Z"
                },
                "quantity": 1,
                "typeID": 671,
                "typeName": "Erebus",
                "typeVolume": 10000000
            },
            {
                "meta": {
                    "bpc": false
                },
                "name": "Avatar",
                "prices": {
                    "all": {
                        "avg": 0,
                        "max": 64840457150.95,
                        "median": 64840457150.95,
                        "min": 64840457150.95,
                        "order_count": 0,
                        "percentile": 64840457150.95,
                        "stddev": 0,
                        "volume": 0
                    },
                    "buy": {
                        "avg": 0,
                        "max": 64840457150.95,
                        "median": 64840457150.95,
                        "min": 64840457150.95,
                        "order_count": 0,
                        "percentile": 64840457150.95,
                        "stddev": 0,
                        "volume": 0
                    },
                    "sell": {
                        "avg": 0,
                        "max": 64840457150.95,
                        "median": 64840457150.95,
                        "min": 64840457150.95,
                        "order_count": 0,
                        "percentile": 64840457150.95,
                        "stddev": 0,
                        "volume": 0
                    },
                    "strategy": "ccp",
                    "updated": "2017-09-16T20:22:26.885313357Z"
                },
                "quantity": 1,
                "typeID": 11567,
                "typeName": "Avatar",
                "typeVolume": 10000000
            }
        ],
        "kind": "listing",
        "market_name": "jita",
        "raw": "Avatar\nErebus\n",
        "totals": {
            "buy": 137945692390.32,
            "sell": 137945692390.32,
            "volume": 20000000
        },
        "unparsed": {}
    }
}