NFT Data and Historical Statistics

Get user volume

Users (top buyers/sellers) leaderboard. Calculated as traded worth for the period.

SecurityApiKeyAuth

Request

path Parameters

entity

required

string (OlapUserType)

Type of users in leaderboard

Enum: "sellers" "buyers"

query Parameters

blockchain	string (OlapBlockchain) Blockchain Enum: "ETHEREUM" "FLOW" "TEZOS" "POLYGON" "SOLANA" "IMMUTABLEX" "MANTLE" "ARBITRUM" "CHILIZ" "LIGHTLINK" "ZKSYNC" "ASTARZKEVM" "BASE" "RARI" "CELO" "FIEF" "XAI" "KROMA" "APTOS" "ZKLINK" "OASYS" "QUAI" "ECLIPSE" "SAAKURU" "OASIS" "PALM" "MATCH" "FIVIRE" "SEI" "CAMP" "LISK" "MOONBEAM" "ETHERLINK" "ZKCANDY" "ALEPHZERO" "BERACHAIN" "ABSTRACT" "SHAPE"
source	string (OlapPlatformSource) Source Enum: "RARIBLE" "OPEN_SEA"
period	string (OlapLeaderboardPeriod) Time period of leaderboard. Default: D7 Enum: "D1" "D7" "D30" "H6" "H1" "MIN30" "MIN5" "ALL"
limit	integer <int32> Default: 10 Limit of records in leaderboard

Responses

200

400

Bad Request

500

Internal Server Error

get/v0.1/data/rankings/{entity}/volume

Response samples

application/json

{"result": [{"id": "ETHEREUM:0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
"items": 178,
"transactions": 11,
"volumeUsd": {"currency": "USD",
"value": 1000
},
"volumeNative": {"currency": "ETH",
"value": 0.75
}
}
]
}

Get NFT Collections volume

Collections leaderboard by trade activity

SecurityApiKeyAuth

Request

query Parameters

source	string (OlapTradesLeaderboardSourceGroup) Group of platform used for volume calculation and collection ranging. Enum: "RARIBLE" "EXTERNAL"
blockchain	string (OlapBlockchain) Blockchain Enum: "ETHEREUM" "FLOW" "TEZOS" "POLYGON" "SOLANA" "IMMUTABLEX" "MANTLE" "ARBITRUM" "CHILIZ" "LIGHTLINK" "ZKSYNC" "ASTARZKEVM" "BASE" "RARI" "CELO" "FIEF" "XAI" "KROMA" "APTOS" "ZKLINK" "OASYS" "QUAI" "ECLIPSE" "SAAKURU" "OASIS" "PALM" "MATCH" "FIVIRE" "SEI" "CAMP" "LISK" "MOONBEAM" "ETHERLINK" "ZKCANDY" "ALEPHZERO" "BERACHAIN" "ABSTRACT" "SHAPE"
ids	Array of strings Collection ids
period	string (OlapLeaderboardPeriod) Time period for aggregation Enum: "D1" "D7" "D30" "H6" "H1" "MIN30" "MIN5" "ALL"
minFloorPriceNative	number <bigdecimal> Show collections which floor price (native currency) more or equal than specified value
maxFloorPriceNative	number <bigdecimal> Show collections which floor price (native currency) less or equal than specified value
sort	string (OlapTradesLeaderboardSort) Default: "VOLUME_USD_DESC" Collections sorting Enum: "VOLUME_USD_ASC" "VOLUME_USD_DESC" "COLLECTION_ASC" "COLLECTION_DESC"
limit	integer <int32> Default: 10 Limit of records in leaderboard
continuation	string Page reference. Taken from previous response

Responses

200

400

Bad Request

500

Internal Server Error

get/v0.1/data/rankings/collections/volume

Response samples

application/json

{"continuation": "45325.07_ETHEREUM:0xe8f88d16f24255fcfab25959705d724406d67d9d",
"result": [{"id": "ETHEREUM:0xe8f88d16f24255fcfab25959705d724406d67d9d",
"volumeUsd": {"currency": "USD",
"value": 45325.07,
"changePercent": -51.196335
},
"volumeNative": {"currency": "ETH",
"value": 23.95
},
"itemsBought": 1,
"floorPrice": {"currency": "ETH",
"value": 24,
"changePercent": -13.5332
},
"listed": 33,
"totalItemSupply": 250,
"ownersCount": 187
}
]
}

Get NFT Collection tx stats

Get historical statistics about Collection transactions

SecurityApiKeyAuth

Request

path Parameters

collection

required

string

Identifier of collection

query Parameters

filters

string

Filters of statistics

Responses

200

400

Bad Request

404

Not found

500

Internal Server Error

get/v0.1/data/collections/{collection}/transactions

Response samples

application/json

{"historicalDates": ["2022-05-05",
"2022-05-06",
"2022-05-07"
],
"historicalValues": [3602,
2566,
285
],
"currentValue": 260
}

Get NFT Collection statsDeprecated

Get general statistics about Collection

SecurityApiKeyAuth

Request

path Parameters

collection

required

string

Identifier of collection

query Parameters

currency

string (OlapCurrencyType)

Default: "USD"

Currency of statistics

Enum: "USD" "ETH" "XTZ" "FLOW" "MATIC" "POL" "SOL" "MNT" "CHZ" "CELO" "FIEF" "XAI" "APT" "OAS" "QUAI" "ROSE" "BNB" "PALM" "FIVIRE" "SEI" "GLMR" "AZERO" "BERA"

Responses

200

400

Bad Request

404

Not found

500

Internal Server Error

get/v0.1/data/collections/{collection}/stats

Response samples

application/json

{"highestSale": 43.71,
"floorPrice": 1.45,
"marketCap": 14529,
"items": 10020,
"owners": 6472,
"volume": 41913.50477591493
}

Get NFT Collection statistics

Get statistics about a collection

SecurityApiKeyAuth

Request

path Parameters

collection

required

string

Identifier of collection

Responses

200

400

Bad Request

404

Not found

500

Internal Server Error

get/v0.1/data/collections/{collection}/statistics

Response samples

application/json

{"listed": 5,
"items": 10020,
"owners": 6472,
"highestSale": [{"currency": "USD",
"value": 37.66
},
{"currency": "ETH",
"value": 0.009
}
],
"floorPrice": [{"currency": "USD",
"value": 2635
},
{"currency": "ETH",
"value": 1
}
],
"marketCap": [{"currency": "USD",
"value": 12195397
},
{"currency": "ETH",
"value": 4627
}
],
"volume": [{"currency": "USD",
"value": 37.66
},
{"currency": "ETH",
"value": 0.009
}
]
}

Get NFT Collection seller stats

Get historical statistics about Collection sellers

SecurityApiKeyAuth

Request

path Parameters

collection

required

string

Identifier of collection

query Parameters

filters

string

Filters of statistics

Responses

200

400

Bad Request

404

Not found

500

Internal Server Error

get/v0.1/data/collections/{collection}/sellers

Response samples

application/json

{"historicalDates": ["2022-05-05",
"2022-05-06",
"2022-05-07"
],
"historicalValues": [2744,
5487,
895
],
"currentValue": 1767
}

Get NFT Collections GVM

Get historical statistics about Collection gross merchandise value

SecurityApiKeyAuth

Request

path Parameters

collection

required

string

Identifier of collection

query Parameters

currency	string (OlapCurrencyType) Default: "USD" Currency of statistics Enum: "USD" "ETH" "XTZ" "FLOW" "MATIC" "POL" "SOL" "MNT" "CHZ" "CELO" "FIEF" "XAI" "APT" "OAS" "QUAI" "ROSE" "BNB" "PALM" "FIVIRE" "SEI" "GLMR" "AZERO" "BERA"
period	string (OlapPeriod) Time period of statistics. Default: D1 Enum: "D1" "D7" "D30"
filters	string Filters of statistics

Responses

200

400

Bad Request

404

Not found

500

Internal Server Error

get/v0.1/data/collections/{collection}/gmv

Response samples

application/json

{"historicalDates": ["2022-05-05",
"2022-05-06",
"2022-05-07"
],
"historicalValues": [10934.527094503102,
7876.5886882554005,
1164.1458323599143
],
"currentValue": 498.19370351666873
}

Get NFT Collection floor price

Get historical statistics about Collection's NFT floor price

SecurityApiKeyAuth

Request

path Parameters

collection

required

string

Identifier of collection

query Parameters

currency	string (OlapCurrencyType) Default: "USD" Currency of statistics Enum: "USD" "ETH" "XTZ" "FLOW" "MATIC" "POL" "SOL" "MNT" "CHZ" "CELO" "FIEF" "XAI" "APT" "OAS" "QUAI" "ROSE" "BNB" "PALM" "FIVIRE" "SEI" "GLMR" "AZERO" "BERA"
filters	string Filters of statistics

Responses

200

400

Bad Request

404

Not found

500

Internal Server Error

get/v0.1/data/collections/{collection}/floorPrice

Response samples

application/json

{"historicalDates": ["2022-05-05",
"2022-05-06",
"2022-05-07"
],
"historicalValues": [1.7,
1.69,
1.9
],
"currentValue": 1.45
}

Get NFT Collection buyer stats

Get historical statistics about Collection buyers

SecurityApiKeyAuth

Request

path Parameters

collection

required

string

Identifier of collection

query Parameters

filters

string

Filters of statistics

Responses

200

400

Bad Request

404

Not found

500

Internal Server Error

get/v0.1/data/collections/{collection}/buyers

Response samples

application/json

{"historicalDates": ["2022-05-08",
"2022-05-09",
"2022-05-10"
],
"historicalValues": [524,
791,
1619
],
"currentValue": 1767
}

Get NFT Collection listing stats

Get historical statistics of collection listed count

SecurityApiKeyAuth

Request

path Parameters

collection

required

string

Identifier of collection

Responses

200

400

Bad Request

404

Not found

500

Internal Server Error

get/v0.1/data/collections/{collection}/listed

Response samples

application/json

{"historicalDates": ["2022-05-08",
"2022-05-09",
"2022-05-10"
],
"historicalValues": [524,
791,
1619
],
"currentValue": 1767
}

➔ Next to Domain lookup