API (Programatic Trading)

Programmatic transactions (algorithmic trading, or PTs) use algorithms and computational schemes to execute transactions with minimal human intervention.

Customers leverage the power of the Mintify API to optimize trading and operational efficiencies, reduce errors, swiftly capitalize on opportunities, integrate Orderbook features into external dApps, and more.

Order Execution

Procedurally execute your trading strategy or embed Mintify-based liquidity and trading functions directly into your dApp. Buy, sell, and trade your in-game assets with deep liquidity without leaving your in-game marketplace.

Risk Management

Algorithmically manage market exposure and risk based on predefined or dynamic variables composed of various actions for mitigating against loss/impermanent loss and rapid market downturns.

Algorithmic Development

Utilize Mintify data feeds for signal generation through statistical models and trading strategies to swiftly identify and capitalize on opportunities with minimal human intervention.

Build Using our API

Get access to full historical and real-time data, cached images, create trading bots, or build your own marketplace on ETH Mainnet, Base and Blast. Learn more here.

Pricing

To get started please fill out this form

	Tier 1	Tier 2
Price	$99/mo	$2499/mo
Requests/Second	100	1500
Chains	ETH, Base, Blast	ETH, Base, Blast, Ordinals (coming soon)
Features	Buy, Bid, List	Buy, Bid, List
Real-time Data	✅	✅

---

PT Instructions

All POST endpoints require the parameters to be posted in the body.

For endpoints that have a "signature" as final step in the response, you need to sign the correct structured data and post it in the endpoint that is mentioned in the response.

This final step has two crucial parts. the "post" object and the "sign" object. The flow is that you need to sign the "sign" object as follows (example using ethersjs):

const signature = await signer.signTypedData(sign.domain, sign.types, sign.value);

Then you need to post the "post.body" object to the endpoint mentioned in the "post.endpoint" property. You need to fill the "post.signature" and "post.maker" with your actual values before posting.

Post a signed order

POSThttps://api.mintify.xyz/api/market/postSignedOrder

Query parameters

Response

200

{object} Status of the posted order

Body

application/json

postSignedOrder (object)

Returns the status of the posted order

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/postSignedOrder?maker=text&signature=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Post a signed Cancellation

POSThttps://api.mintify.xyz/api/market/postSignedCancellation

Query parameters

Response

200

{object} Status of the posted cancellation

Body

application/json

postSignedCancellation (object)

Returns the status of the posted order

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/postSignedCancellation?maker=text&signature=text&orderKind=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Prepare a token bid order for a specific contract and token id.

POSThttps://api.mintify.xyz/api/market/createTokenBid

Query parameters

Response

200

{array} Array of steps to execute the order. Last step is signing the order and sending it to the postSignedOrder endpoint.

Body

application/json

createTokenBid (array of object)

Returns array of steps that need to be completed. The last step has instructions on how to sign and post the final order

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/createTokenBid?contract=text&tokenId=0&maker=text&price=0&expiration=0&market=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

[]

Prepare a collection bid order for a specific contract and token id.

POSThttps://api.mintify.xyz/api/market/createCollectionBid

Query parameters

Response

200

{array} Array of steps to execute the order. Last step is signing the order and sending it to the postSignedOrder endpoint.

Body

application/json

createCollectionBid (array of object)

Returns array of steps that need to be completed. The last step has instructions on how to sign and post the final order

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/createCollectionBid?contract=text&maker=text&price=0&expiration=0&market=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

[]

Prepare a listing order for a specific contract and token id.

POSThttps://api.mintify.xyz/api/market/createListing

Query parameters

Response

200

{array} Array of steps to execute the order. Last step is signing the order and sending it to the postSignedOrder endpoint.

Body

application/json

createListing (array of object)

Returns array of steps that need to be completed. The last step has instructions on how to sign and post the final order

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/createListing?contract=text&tokenId=0&maker=text&price=0&expiration=0&market=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

[]

Cancel an order by its order id.

POSThttps://api.mintify.xyz/api/market/cancelOrder

Query parameters

Response

200

{object} Status of the order cancellation

Body

application/json

cancelOrder (array of object)

Returns array of steps that need to be completed. The last step has instructions on how to sign and post the final order

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/cancelOrder?orderId=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

[]

Buy a listed token by its order id.

POSThttps://api.mintify.xyz/api/market/buyListing

Query parameters

Response

200

{object} Status of the order purchase action

Body

application/json

buyListing (array of object)

Returns array of steps that need to be completed. The last step has instructions on how to sign and post the final order

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/buyListing?orderId=text&taker=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

[]

Accept an offer for a listed token by its order id.

POSThttps://api.mintify.xyz/api/market/acceptOffer

Query parameters

Response

200

{object} Status of the order purchase action

Body

application/json

acceptOffer (array of object)

Returns array of steps that need to be completed. The last step has instructions on how to sign and post the final order

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/acceptOffer?orderId=text&owner=text&contract=text&tokenId=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

[]

Get user's list orders for collection.

GEThttps://api.mintify.xyz/api/market/getUserListings

Query parameters

Response

200

{array} Array of listings

Body

application/json

order_idstring

The order id

contract_addressstring

The contract address

token_idstring

The token id

creation_datestring

The creation date

expiration_datestring

The expiration date

pricenumber

The chain-native price of the listing

currency_pricenumber

The currency price of the listing

currencynumber

The currency of the listing

marketstring

The market the listing is on

makerstring

The maker address

quantitystring

The quantity

updatedstring

The updated date

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/getUserListings?contract=text&owner=text&tokenId=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "order_id": "text",
    "contract_address": "text",
    "token_id": "text",
    "creation_date": "text",
    "expiration_date": "text",
    "price": 0,
    "currency_price": 0,
    "currency": 0,
    "market": "text",
    "maker": "text",
    "quantity": "text",
    "updated": "text"
  }
]

Get user's bid orders for collection.

GEThttps://api.mintify.xyz/api/market/getUserBids

Query parameters

Response

200

{array} Array of bids

Body

application/json

order_idstring

The order id

contract_addressstring

The contract address

token_idstring

The token id

creation_datestring

The creation date

expiration_datestring

The expiration date

pricenumber

The chain-native price of the bid

currency_pricenumber

The currency price of the bid

currencynumber

The currency of the bid

marketstring

The market the bid is on

makerstring

The maker address

quantitystring

The quantity

updatedstring

The updated date

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/market/getUserBids?contract=text&owner=text&tokenId=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "order_id": "text",
    "contract_address": "text",
    "token_id": "text",
    "creation_date": "text",
    "expiration_date": "text",
    "price": 0,
    "currency_price": 0,
    "currency": 0,
    "market": "text",
    "maker": "text",
    "quantity": "text",
    "updated": "text"
  }
]