Maestro Docs

Rune Trades for DEX

curl --request GET \
  --url https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol} \
  --header 'api-key: <api-key>'

import requests

url = "https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}"

headers = {"api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "amount": 3780,
      "block": 840000,
      "dex": "magiceden",
      "mempool": false,
      "price": 19.75,
      "price_usd": 0.0575,
      "side": "buy",
      "symbol": "BTC-840000:28",
      "timestamp": "2024-05-03T15:04:05Z",
      "tx_hash": "2bebfc71ac93f02de19b28a8b438ed40413676f4c4c2609401a9a08ea508fd58",
      "tx_index": 1
    }
  ]
}

{
  "error": "Bad Request"
}

{
  "error": "Bad Request"
}

GET

dexs

trades

{dex}

{symbol}

Rune Trades for DEX

curl --request GET \
  --url https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol} \
  --header 'api-key: <api-key>'

import requests

url = "https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}"

headers = {"api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://xbt-mainnet.gomaestro-api.org/v0/markets/dexs/trades/{dex}/{symbol}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "amount": 3780,
      "block": 840000,
      "dex": "magiceden",
      "mempool": false,
      "price": 19.75,
      "price_usd": 0.0575,
      "side": "buy",
      "symbol": "BTC-840000:28",
      "timestamp": "2024-05-03T15:04:05Z",
      "tx_hash": "2bebfc71ac93f02de19b28a8b438ed40413676f4c4c2609401a9a08ea508fd58",
      "tx_index": 1
    }
  ]
}

{
  "error": "Bad Request"
}

{
  "error": "Bad Request"
}

Authorizations

api-key

string

header

required

Project API Key

Path Parameters

dex

enum<string>

default:magiceden

required

Name of the DEX

Available options:

all,

magiceden,

dotswap

symbol

string

default:BTC-840000:28

required

Symbol of the Rune asset trading pair (BTC-Rune ID)

Query Parameters

mempool

enum<string>

default:excluded

Mempool mode

Available options:

included,

excluded,

only

from

string

default:1735689600

Start timestamp in Unix

string

default:1742428800

End timestamp in Unix

limit

integer

default:5000

Limit number of Runes returned (min: 1, max: 50000)

Required range: 1 <= x <= 50000

sort

enum<string>

default:desc

Sort by descending (desc) or ascending (asc)

Available options:

asc,

desc

Response

data

object[]

Show child attributes

Blockchain Indexer API

Esplora API

Node RPC API

Mempool Monitoring API

Event Manager API

Market Price API

Wallet API

Rune Trades for DEX

Authorizations

Path Parameters

Query Parameters

Response