Gallop Ethereum API
The Ethereum API from Gallop — 28 operation(s) for ethereum.
OpenAPI Specification
openapi: 3.0.2
info:
title: Analytics Ethereum API
description: Sales, pricing, performance, and marketplace data, all in one place with low latency.
termsOfService: https://higallop.com/terms/
contact:
email: support@higallop.com
license:
name: UNLICENSED
version: 1.0.0
servers:
- url: https://api.prod.gallop.run/v1
tags:
- name: Ethereum
paths:
/analytics/eth/getCollectionListingsOHLC:
post:
security:
- api_key: []
summary: Collection Floor Price and Listings Candlesticks
description: Returns historical floor price or more extensive open / high / floor / close candlesticks for collection listings at marketplaces at a selected time interval, as well as the number of active listings, the number of unique owners and the average age of open listings
operationId: getEthCollectionListingsOHLC
tags:
- Ethereum
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The Ethereum contract address to identify the collection.
example: '0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7'
floor_only:
type: boolean
description: If `true`, report only historical floor prices. Otherwise, report OHFC candlesticks, number of active listings, number of unique owners and the average age of open listings.
example: true
frequency:
type: string
description: The interval at which to return Floor prices / OHLF, e.g. `1D` for daily, `1M` for monthly etc. Must be >= `6H`
example: 1D
rept_curr:
type: string
enum:
- eth
- usd
description: The currency to report results in
example: eth
report_start_date:
type: string
description: The ISO 8601 start date/datetime to return results for
example: '2023-01-01T00:00:00.000Z'
report_end_date:
type: string
description: The ISO 8601 end date/datetime to return results for
example: '2023-01-01T00:00:00.000Z'
trait_type:
type: string
description: Specify if results to be reported only for certain values of this trait type
example: shirt
trait_value:
type: array
description: The trait value(s) of type `trait_type` to report results for
items:
type: string
example: skull tee
required:
- collection_address
responses:
'200':
description: An object containing the collection sales OHLC prices
content:
application/json:
example:
status: 200
response:
collection_address: '0x0c2e57efddba8c768147d1fdf9176a0a6ebd5d83'
response:
- timestamp: '2023-01-01 00:00:00'
num_active_listings: 138
num_unique_owners: 26
average_listing_age: 3311
open:
price: 0.2361
token_id: '8911'
marketplace_name: LooksRare
high:
price: 24.2069
token_id: '0'
marketplace_name: LooksRare
floor:
price: 0.2069
token_id: '9065'
marketplace_name: LooksRare
close:
price: 1.8037
token_id: '2742'
marketplace_name: LooksRare
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/eth/getCollectionPriceDiff:
post:
security:
- api_key: []
summary: Price Differentiation by Trait
description: Returns how trait differentiates price for a given collection
operationId: getEthCollectionPriceDiff
tags:
- Ethereum
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The Ethereum contract address to identify the collection.
example: '0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7'
start_date:
type: string
description: The start timestamp in ISO 8601 format to pull data for calculations.
example: '2023-01-01T00:00:00.000Z'
end_date:
type: string
description: The end timestamp in ISO 8601 format to pull data for calculations
example: '2023-01-01T00:00:00.000Z'
exclude_wash:
type: boolean
description: Exclude suspected wash transactions?
example: 'true'
required:
- collection_address
responses:
'200':
description: An object containing the collection's price differentiation
content:
application/json:
example:
status: 200
response:
- Earring: 22
Glasses: 0
Glasses Color: 4
Hair Color: 9
Hair Style: 100
Pants: 12
Pants Color: 9
Shirt: 5
Shirt Color: 19
Shoes: 17
Shoes Color: 2
Type: 34
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/eth/getCollectionSalesOHLC:
post:
security:
- api_key: []
summary: Collection Sales Price Candlesticks
description: Returns collection sales price open, high, low, close and volume at a selected time interval
operationId: getEthCollectionSalesOHLC
tags:
- Ethereum
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The Ethereum contract address to identify the collection.
example: '0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7'
frequency:
type: string
description: The interval at which to return OHLC, e.g. `1D` for daily, `1M` for monthly etc.
example: 1D
group_by:
type: string
description: An attribute of the NFT to group results by.
example: Hat
volume:
type: boolean
description: If 'true', response dicts contain OHLCV
example: false
n_trades:
type: boolean
description: If 'true', append number of trades to OHLC(V)
example: false
rept_curr:
type: string
enum:
- eth
- usd
description: The currency to report results in
example: eth
start_date:
type: string
description: The start timestamp in ISO 8601 format to pull data for calculations
example: '2023-01-01T00:00:00.000Z'
end_date:
type: string
description: The end timestamp in ISO 8601 format to pull data for calculations
example: '2023-01-01T00:00:00.000Z'
exclude_wash:
type: boolean
description: Exclude suspected wash transactions?
example: 'true'
required:
- collection_address
responses:
'200':
description: An object containing the collection sales OHLC prices
content:
application/json:
example:
status: 200
response:
collection_address:
- '0xb7f7f6c52f2e2fdb1963eab30438024864c313f6'
- '0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb'
ohlc:
- block_timestamp: '2022-07-18 00:00:00'
body_type: Female
close: 83
high: 95
low: 83
open: 84.5
- block_timestamp: '2022-07-19 00:00:00'
body_type: Female
close: 83.95
high: 83.95
low: 79
open: 79
- block_timestamp: '2022-07-18 00:00:00'
body_type: Male
close: 105
high: 105
low: 84
open: 90
- block_timestamp: '2022-07-19 00:00:00'
body_type: Male
close: 90
high: 90
low: 90
open: 90
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/eth/getCollectionSummary:
post:
security:
- api_key: []
summary: Summary Statistics by Collection
description: Returns summary analytics for a given collection
operationId: getEthCollectionSummary
tags:
- Ethereum
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The contract address of the collection.
example: '0x3f5fb35468e9834a43dca1c160c69eaae78b6360'
group_by:
type: string
description: An attribute of the NFT.
example: Fur
start_date:
type: string
description: The start timestamp in ISO 8601 format to pull data for calculations
example: '2023-01-01T00:00:00.000Z'
end_date:
type: string
description: The end timestamp in ISO 8601 format to pull data for calculations
example: '2023-01-01T00:00:00.000Z'
rept_curr:
type: string
enum:
- eth
- usd
description: The currency to report results in
example: eth
exclude_wash:
type: boolean
description: Exclude suspected wash transactions?
example: 'true'
required:
- collection_address
responses:
'200':
description: An object containing the collection's analytical summary.
content:
application/json:
example:
status: 200
response:
- avg_daily_floor_price_transacted: 0.11913347517730496
avg_daily_transaction_count: 101.68617021276596
avg_daily_volume: 68.80757258912233
gain_since_last_trough: 36.75213675213678
latest_floor_price: 0.08
latest_peak_date: '2022-02-23'
latest_rolling_median: 0.46499999999999997
latest_rolling_quantile: 0.075
latest_trough_date: '2022-02-21'
loss_since_last_peak: -9.909909909909908
max_daily_floor_price: 0.545
min_daily_floor_price: 2.5e-05
total_transaction_count: 19117
total_transaction_volume: 12935.823646754998
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/eth/getDailyCollectionFloor:
post:
security:
- api_key: []
summary: Daily Floor Prices by Collection
description: Returns historical floor price on a daily interval in ETH
operationId: getEthDailyCollectionFloor
tags:
- Ethereum
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The Ethereum contract address to identify the collection.
example: '0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7'
required:
- collection_address
responses:
'200':
description: An object containing the collection floor prices
content:
application/json:
example:
status: 200
response:
collection_address: '0x0c2e57efddba8c768147d1fdf9176a0a6ebd5d83'
response:
- timestamp: '2023-01-01 00:00:00'
floor: 0.2142
- timestamp: '2023-01-02 00:00:00'
floor: 0.2122
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/eth/getLeaderBoard:
post:
security:
- api_key: []
summary: Ethereum Leaderboard by Collection
description: Returns top collections by volume transaction volume or sales count
operationId: getEthLeaderBoard
tags:
- Ethereum
requestBody:
content:
application/json:
schema:
type: object
properties:
page:
type: integer
description: The pagination cursor.
example: 1
page_size:
type: integer
enum:
- 50
- 100
- 500
- 1000
description: The number of records returned per page.
example: 100
interval:
type: string
enum:
- one_day
- seven_days
- thirty_days
- ninety_days
- all_time
description: The requested time interval
example: one_day
ranking_metric:
type: string
enum:
- eth_volume
- sales_count
description: The requested calculation metric
example: eth_volume
required:
- interval
- ranking_metric
responses:
'200':
description: OK
content:
application/json:
example:
status: 200
response:
total_items: 1000
total_pages: 20
page: 1
interval: all_time
ranking_metric: eth_volume
leaderboard:
- rank: 1
collection_address: '0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d'
collection_name: BoredApeYachtClub
value: 893824.39
type: ERC-721
symbol: BAYC
- rank: 2
collection_address: '0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb'
collection_name: CRYPTOPUNKS
value: 881880.76
type: null
symbol: Ͼ
- rank: 3
collection_address: '0x60e4d786628fea6478f785a6d7e704777c86a7c6'
collection_name: MutantApeYachtClub
value: 594921.89
type: ERC-721
symbol: MAYC
- rank: 4
collection_address: '0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258'
collection_name: Otherdeed
value: 460918.98
type: ERC-721
symbol: OTHR
- rank: 5
collection_address: '0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270'
collection_name: Art Blocks
value: 377598.11
type: ERC-721
symbol: BLOCKS
- rank: 6
collection_address: '0xed5af388653567af2f388e6224dc7c4b3241c544'
collection_name: Azuki
value: 341917.75
type: ERC-721
symbol: AZUKI
- rank: 7
collection_address: '0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b'
collection_name: CloneX
value: 290730.21
type: ERC-721
symbol: CloneX
- rank: 8
collection_address: '0x23581767a106ae21c074b2276d25e5c3e136a68b'
collection_name: Moonbirds
value: 226458.36
type: ERC-721
symbol: MOONBIRD
- rank: 9
collection_address: '0x8a90cab2b38dba80c64b7734e58ee1db38b8992e'
collection_name: Doodles
value: 185765.51
type: ERC-721
symbol: DOODLE
- rank: 10
collection_address: '0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7'
collection_name: Meebits
value: 177549.02
type: ERC-721
symbol: ⚇
- rank: 11
collection_address: '0xba30e5f9bb24caa003e9f2f0497ad287fdf95623'
collection_name: BoredApeKennelClub
value: 141699.65
type: ERC-721
symbol: BAKC
- rank: 12
collection_address: '0x1a92f7381b9f03921564a437210bb9396471050c'
collection_name: Cool Cats
value: 121509.7
type: ERC-721
symbol: COOL
- rank: 13
collection_address: '0x50f5474724e0ee42d9a4e711ccfb275809fd6d4a'
collection_name: Sandbox's LANDs
value: 110297.65
type: ERC-721
symbol: LAND
- rank: 14
collection_address: '0xff9c1b15b16263c61d017ee9f65c50e4ae0113d7'
collection_name: Loot
value: 91489.79
type: ERC-721
symbol: LOOT
- rank: 15
collection_address: '0x306b1ea3ecdf94ab739f1910bbda052ed4a9f949'
collection_name: Beanz
value: 89783.46
type: ERC-721
symbol: BEANZ
- rank: 16
collection_address: '0xe785e82358879f061bc3dcac6f0444462d4b5330'
collection_name: World Of Women
value: 77541.48
type: ERC-721
symbol: WOW
- rank: 17
collection_address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8'
collection_name: PudgyPenguins
value: 73515.5
type: ERC-721
symbol: PPG
- rank: 18
collection_address: '0x1cb1a5e65610aeff2551a50f76a87a7d3fb649c6'
collection_name: Cryptoadz
value: 71788.15
type: ERC-721
symbol: TOADZ
- rank: 19
collection_address: '0x059edd72cd353df5106d2b9cc5ab83a52287ac3a'
collection_name: Art Blocks
value: 64538.77
type: ERC-721
symbol: BLOCKS
- rank: 20
collection_address: '0x57a204aa1042f6e66dd7730813f4024114d74f37'
collection_name: CyberKongz
value: 62063.11
type: ERC-721
symbol: KONGZ
- rank: 21
collection_address: '0xa3aee8bce55beea1951ef834b99f3ac60d1abeeb'
collection_name: VeeFriends
value: 59176.68
type: ERC-721
symbol: VFT
- rank: 22
collection_address: '0xbce3781ae7ca1a5e050bd9c4c77369867ebc307e'
collection_name: goblintown
value: 58468.89
type: ERC-721
symbol: GOBLIN
- rank: 23
collection_address: '0x4db1f25d3d98600140dfc18deb7515be5bd293af'
collection_name: HAPE PRIME
value: 57607.58
type: ERC-721
symbol: HAPE
- rank: 24
collection_address: '0x160c404b2b49cbc3240055ceaee026df1e8497a0'
collection_name: projectPXN
value: 57178.91
type: ERC-721
symbol: GHOST
- rank: 25
collection_address: '0xbd4455da5929d5639ee098abfaa3241e9ae111af'
collection_name: NFT Worlds
value: 55017.03
type: ERC-721
symbol: NFT Worlds
- rank: 26
collection_address: '0x9c8ff314c9bc7f6e59a9d9225fb22946427edc03'
collection_name: Nouns
value: 51082.04
type: ERC-721
symbol: NOUN
- rank: 27
collection_address: '0x3bf2922f4520a8ba0c2efc3d2a1539678dad5e9d'
collection_name: 0N1 Force
value: 49527.75
type: ERC-721
symbol: 0N1
- rank: 28
collection_address: '0x9a534628b4062e123ce7ee2222ec20b86e16ca8f'
collection_name: MekaVerse
value: 49089.54
type: ERC-721
symbol: MEKA
- rank: 29
collection_address: '0x59468516a8259058bad1ca5f8f4bff190d30e066'
collection_name: Invisible Friends
value: 47762.17
type: ERC-721
symbol: INVSBLE
- rank: 30
collection_address: '0x79fcdef22feed20eddacbb2587640e45491b757f'
collection_name: mfer
value: 46001.04
type: ERC-721
symbol: MFER
- rank: 31
collection_address: '0xd2f668a8461d6761115daf8aeb3cdf5f40c532c6'
collection_name: Karafuru
value: 45111.59
type: ERC-721
symbol: KARAFURU
- rank: 32
collection_address: '0x60bb1e2aa1c9acafb4d34f71585d7e959f387769'
collection_name: Art Gobblers
value: 44747.72
type: ERC-721
symbol: GOBBLER
- rank: 33
collection_address: '0xc2c747e0f7004f9e8817db2ca4997657a7746928'
collection_name: Hashmasks
value: 41838.36
type: ERC-721
symbol: HM
- rank: 34
collection_address: '0x341a1c534248966c4b6afad165b98daed4b964ef'
collection_name: Murakami.Flowers Seed
value: 40811.53
type: ERC-1155
symbol: SEED
- rank: 35
collection_address: '0xccc441ac31f02cd96c153db6fd5fe0a2f4e6a68d'
collection_name: FLUF
value: 39839.97
type: ERC-721
symbol: FLUF
- rank: 36
collection_address: '0x5cc5b05a8a13e3fbdb0bb9fccd98d38e50f90c38'
collection_name: Sandbox's LANDs
value: 38580.76
type: ERC-721
symbol: LAND
- rank: 37
collection_address: '0x892848074ddea461a15f337250da3ce55580ca85'
collection_name: CyberBrokers
value: 37433.61
type: ERC-721
symbol: CYBERBROKERS
- rank: 38
collection_address: '0x82c7a8f707110f5fbb16184a5933e9f78a34c6ab'
collection_name: Emblem Vault V4
value: 37318.84
type: ERC-721
symbol: Emblem.pro
- rank: 39
collection_address: '0xb4d06d46a8285f4ec79fd294f78a881799d8ced9'
collection_name: 3Landers
value: 36722.12
type: ERC-721
symbol: 3L
- rank: 40
collection_address: '0xc92ceddfb8dd984a89fb494c376f9a48b999aafc'
collection_name: Creature World
value: 35635.74
type: ERC-721
symbol: CREATURE
- rank: 41
collection_address: '0x67d9417c9c3c250f61a83c7e8658dac487b56b09'
collection_name: Phanta Bear
value: 35191.14
type: ERC-721
symbol: PHB
- rank: 42
collection_address: '0x7ea3cca10668b8346aec0bf1844a49e995527c8b'
collection_name: CyberKongz VX
value: 34548.88
type: ERC-721
symbol: KONGZ VX
- rank: 43
collection_address: '0x28472a58a490c5e09a238847f66a68a47cc76f0f'
collection_name: 'adidas Originals: Into the Metaverse'
value: 34463.89
type: ERC-1155
symbol: ADI
- rank: 44
collection_address: '0x2acab3dea77832c09420663b0e1cb386031ba17b'
collection_name: DeadFellaz
value: 31868.21
type: ERC-721
symbol: DEADFELLAZ
- rank: 45
collection_address: '0x282bdd42f4eb70e7a9d9f40c8fea0825b7f68c5d'
collection_name: V1 Cryptopunks (Wrapped)
value: 31812.88
type: ERC-721
symbol: WPV1
- rank: 46
collection_address: '0x0c2e57efddba8c768147d1fdf9176a0a6ebd5d83'
collection_name: KaijuKingz
value: 31742.55
type: ERC-721
symbol: KAIJU
- rank: 47
collection_address: '0xfe8c6d19365453d26af321d0e8c910428c23873f'
collection_name: Cold Blooded Creepz
value: 31446.45
type: ERC-721
symbol: CBC
- rank: 48
collection_address: '0x86c10d10eca1fca9daf87a279abccabe0063f247'
collection_name: Cool Pets
value: 31428.01
type: ERC-721
symbol: PETS
- rank: 49
collection_address: '0x8943c7bac1914c9a7aba750bf2b6b09fd21037e0'
collection_name: Lazy Lions
value: 31216.72
type: ERC-721
symbol: LION
- rank: 50
collection_address: '0xf61f24c2d93bf2de187546b14425bf631f28d6dc'
collection_name: World Of Women Galaxy
value: 30781.83
type: ERC-721
symbol: WOWG
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/eth/getRarity:
post:
security:
- api_key: []
summary: Token Rarity by Collection
description: Returns rarity by token for a given collection
operationId: getEthRarity
tags:
- Ethereum
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The Ethereum contract address to identify the collection.
example: '0x716039ab9ce2780e35450b86dc6420f22460c380'
weights:
type: object
description: Dict containing trait keys and weight values.
properties: {}
example:
Clothes: 0.1
Ears: 0.1
Eyes: 1
Head: 0.1
Mouth: 0.1
Rarity: 0.1
Trait Count: 0.1
token_id:
type: array
description: An array of token ids.
items:
type: string
example: '1327'
required:
- collection_address
responses:
'200':
description: OK
content:
application/json:
example:
status: 200
response:
- token_id: '1357'
token_name: 'Cool Monke #1357'
rarity_score: 0.0831
trait_rarity_score:
Ears: 0.0008
Eyes: 0.0221
Head: 0.0015
Mouth: 0.0221
Rarity: 0.0029
Clothes: 0.033
Overall: 0.0831
Trait Count: 0.0007
- token_id: '3333'
token_name: 'Cool Monke #3333'
rarity_score: 0.1984
trait_rarity_score:
Ears: 0.0008
Eyes: 0.0221
Head: 0.0015
Mouth: 0.0387
Rarity: 0.005
Clothes: 0.1296
Overall: 0.1984
Trait Count: 0.0007
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/eth/getTokenSummary:
post:
security:
- api_key: []
summary: Summary Statistics by Token
description: Returns summary analytics for a given token
operationId: getEthTokenSummary
tags:
- Ethereum
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The contract address of the token collection.
example: '0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb'
token_id:
type: array
description: The id for the token.
items:
type: string
example: '6000'
start_date:
type: string
description: The start timestamp in ISO 8601 format to pull data for calculations
example: '2023-01-01T00:00:00.000Z'
end_date:
# --- truncated at 32 KB (144 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gallop/refs/heads/main/openapi/gallop-ethereum-api-openapi.yml