Skip to content
GET /v1/listings

Live order book of tokens on sale

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/magiceden-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/magiceden-api/v1/listings" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/magiceden-api/v1/listings", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/magiceden-api/v1/listings");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/magiceden-api/v1/listings",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "count": 20,
        "limit": 20,
        "offset": 0,
        "source": "Magic Eden",
        "symbol": "okay_bears",
        "listings": [
            {
                "seller": "HNSERyK1yKQrdp3GWCXNogdALqmJviKeuWMZyeyh1Jrs",
                "price_sol": 1.6443,
                "token_mint": "AwsftwacmNavwSd59bekD2ty6fip8w24BPAVF6K6gcq7",
                "token_size": 1,
                "rarity_rank": 6601,
                "auction_house": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
                "token_address": "3bpMmrSvCZQRqYrpwNkTdWMnba1kDmpMkpAkWW2EEPs2"
            },
            {
                "seller": "7zcRWrKMimPowkEnvqw7q3RznLSGieKFCoM4wNmxyUg4",
                "price_sol": 1.64431,
                "token_mint": "GU6pHuFeT4d6qf9TZzf6JVkcKArV5NNC4gPfqPJLXMrk",
                "token_size": 1,
                "rarity_rank": 4364,
                "auction_house": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
                "token_address": "Ff8zWpVDk1ECB4RMFjCiGhyTdsN6QJ7HNFbETvPAE6K5"
            },
            {
                "seller": "HNSERyK1yKQrdp3GWCXNogdALqmJviKeuWMZyeyh1Jrs",
                "price_sol": 1.69999,
                "token_mint": "GayrNcKgarxqayzNDfo3RnaBBC3AC4BbmcngTpGk2wRf",
                "token_size": 1,
                "rarity_rank": 8202,
                "auction_house": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
                "token_address": "22pyMFpJbKgfqWJZXSUR8dwv1ytyriwbmnQdT1qPpANP"
            },
            {
                "seller": "275PsEUVMNUdH46VbPMkjtieR19U4zJX1HdsUaXgF4dL",
                "price_sol": 1.8,
                "token_mint": "52nJ1X6hXZ8DTuVkPLTwaQU9G1LAPQqEpH1ksHn58341",
                "token_size": 1,
                "rarity_rank": 7753,
                "auction_house": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
                "token_address": "GPLqgepJ2o38YZJf397rgYy7pSR1qNSRYwXrCHVwzjWj"
            },
            {
                "seller": "72gerdWptoK9bKvHmcmNrFwZFXQjdnaPKAMFqNUh1bJk",
                "price_sol": 1.9,
                "token_mint": "GggX2Peg8bwcx5soBJzcEabLZxJHbhAukqyrwgSVDcnZ",
                "token_size": 1,
                "rarity_rank": 7217,
                "auction_house": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
                "token_address": "DCMiN7XeeFUjoYy52VoUZzFtraDpAMw2yhAbi64hGxkn"
            },
            {
                "seller": "FD8s8ruJ4LnhYGzHn6beWHNyZyFbfy4MVp6o3uAKkVjA",
                "price_sol": 1.9,
                "token_mint": "NEoAKrNuHqHou4wPnTGAjJj9MX7sbQftWbr1DU2qdCg",
                "token_size": 1,
                "rarity_rank": 7874,
                "auction_house": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
                "token_address": "F5x7LTB4nSihZ8JvRMYPKXqDYhFHojgfJBo9oiT2xnYk"
            },
            {
                "seller": "gYTKoKsMHTt5ADfJjDTZRiaJCMd5cU2TWhZPG8yprCv",
                "price_sol": 1.9995,
                "token_mi
…