Mirror API

Search…
Mirror API
This section provides a brief guide on how to get set up with Mirror API. For more information, be sure to check out source code and documentation on GitHub.
The Mirror API (also known as Mirror Graph) is an GraphQL-based data service that allows anybody to query data regarding the current and aggregate application state of the Mirror Protocol. Potential consumers of data include: dashboards, mAsset arbitrage trading bots, dApp activity trackers, etc.
Endpoints
Since Mirror API is a GraphQL-based data service, it is not accessed like a traditional REST API with many different endpoints. Instead, there is only one endpoint served over HTTP, to which you can submit a POST request containing a GraphQL query.
​
Chain ID
URL
Mainnet
columbus-5
​https://graph.mirror.finance/graphql​
Testnet
bombay-12
​https://bombay-graph.mirror.finance/graphql​
Usage
You can access Mirror API through a variety of interfaces that support GraphQL. Below are some examples of how you can use Mirror API:
GraphiQL
Playground: https://graph.mirror.finance/graphql​
An easy way to explore the Mirror API is to use your browser to access the GraphiQL interface served directly on the endpoint address. GraphiQL is an interactive interface where you can construct queries alongside easy access to the API's schema and documentation. This allows for quick, iterative experimentation as you can directly run your queries and compare results.
HTTP
You can access Mirror API through standard HTTP by simply sending a GraphQL query to the endpoint through a POST request. The response will be in JSON.
If you intend to use Mirror API in a programmatic context (like within JavaScript or Python), it is recommended to use a GraphQL client such as Relay or Apollo to handle the ceremony of making HTTP requests and parsing returned responses.
Example using cURL
1
curl -X POST \
2
-H "Content-Type: application/json" \
3
-d '{"query": "{ assets { symbol name } }"}' \
4
https://tequila-graph.mirror.finance/graphql
Copied!
Response (prettified)
1
{
2
  "data":{
3
    "assets":[
4
      {
5
        "symbol":"MIR",
6
        "name":"Mirror",
7
        "prices":{
8
          "price":null
9
        }
10
      },
11
      {
12
        "symbol":"mAAPL",
13
        "name":"Apple",
14
        "prices":{
15
          "price":"120.825733"
16
        }
17
      },
18
      {
19
        "symbol":"mGOOGL",
20
        "name":"Google",
21
        "prices":{
22
          "price":"1766.556244"
23
        }
24
      },
25
      ...
26
    ]
27
}
Copied!
Developers - Previous
Mirror.js
Next - User Guide
Web App
Last modified 3mo ago
Copy link
Contents