Magic Eden API (Beta)

## Endpoints

More info about Solana clusters: [https://docs.solana.com/clusters](https://docs.solana.com/clusters)

* Devnet: **api-devnet.magiceden.dev/v2** - this uses a testing Solana cluster, the tokens are not real
* Mainnet: **api-mainnet.magiceden.dev/v2** - this uses the real Solana cluster, the tokens are real and this is consistent with the data seen on [https://magiceden.io/](https://magiceden.io/)


## Rate Limiting

* This public API is free to use and the default limit is 120 QPM or 2 QPS
* If you need a higher limit, please fill out [this form](https://airtable.com/shrsYtSEJ8M8ESaNq), and feel free to join us on [Discord](https://discord.gg/magiceden)!
* If calling the endpoints in batch, please add a small timeout between requests to avoid connection refusal (this applies to both users with and without API keys)


## Highlight Projects

You can find a list of projects in analytics, trader tooling, and community managements from our [NYC Hacker House Hackathon Gallery.](https://magic-eden-api-hackathon.devpost.com/project-gallery)

##### The Winners in each respective categories are:

Analytics Project: [Seller Classification](https://devpost.com/software/analytics-seller-classification)
Best Trader Tooling: [Solset.io](https://devpost.com/software/solset-io)
Best Social Media Integration: [Hawksight Bot Improvements via Magic Eden API](https://devpost.com/software/hawksight-x-magic-eden-api-hackathon)

## API Metadata

Some endpoints in this API are able to respond with some useful metadata if requested. This is done by including the request header `ME-Pub-API-Metadata` and the value of this request header is a JSON object with the following TypeScript interface:

``` json
interface RequestMetadata {
paging?: boolean
}

```

If an endpoint is requested with the header (and supports) `ME-Pub-API-Metadata`, the endpoint will respond with a header of the same name (`ME-Pub-API-Metadata`). The value of this response header is a JSON object with the following TypeScript interface:

``` json
interface ResponseMetadata {
paging?: PagingMetadata
}
interface PagingMetadata {
total: number
start: number
end: number
}

```

The below is an example
Request headers:
`ME-Pub-API-Metadata: {"paging":true}`

Response headers:
`ME-Pub-API-Metadata: {"paging":{"total":10, "start":0, "end":1}}`