Offers

Offers capture significant activities related to tokens, offering a detailed view of offers.

The Offer Model

The offer model chronicles the various activities associated with tokens on the ArkProject platform. Each offer is tied to a specific token_address and token_id, pinpointing the exact token involved in the event.

Properties

Name
token_address
Type
string
Description
Unique identifier for the token contract.
Name
token_id
Type
string
Description
Token ID.
Name
current_owner
Type
string
Description
The address of the owner of the token.
Name
current_price
Type
string
Description
Price of the token.
Name
offers
Type
array
Description
Offers's array of the token.
Name
offers.offer_maker
Type
string
Description
Who did the offer.
Name
offers.offer_amount
Type
string
Description
Amount for the offer.
Name
offers.offer_quantity
Type
string
Description
Number of token included in the offer.
Name
offers.offer_timestamp
Type
string
Description
Timestamp of the offer.

GET/token/{contract_address}/{token_id}/offers

Retrieve offers for a specific token

This endpoint allows you to retrieve the offers made on a specific token.

Path parameters

Name
contract_address
Type
string
Description
Hexadecimal address of the contract.
Name
token_id
Type
string
Description
Hexadecimal or decimal token ID.

Request

GET

/token/{contract_address}/{token_id}/offers

curl https://api-orderbook.arkproject.dev/token/{contract_address}/{token_id}/offers

Response

{
    "result": {
        "contract_address": "0x05dbdedc203e92749e2e746e2d40a768d966bd243df04a6b712e222bc040a9af",
        "token_id": "0x000000000000000000000000000000000000000000000000000000000098db9a",
        "current_owner": "0x00a69e64b09ef9830305c3e3166e2b42b3b38edd054c18a9105974f7eb949826",
        "current_price": "1000",
        "offers": [
            {
                "offer_maker": "0x02b69e64b09ef9830305c3e3166e2b42b3b38edd054c18a9105974f7eb949827",
                "offer_amount": "1200",
                "offer_quantity": "2",
                "offer_timestamp": 1625348600
            },
            {
                "offer_maker": "0x03a69e64b09ef9830305c3e3166e2b42b3b38edd054c18a9105974f7eb949828",
                "offer_amount": "1300",
                "offer_quantity": "1",
                "offer_timestamp": 1625449600
            }
        ]
    }
}