Gallop Polygon API
The Polygon API from Gallop — 21 operation(s) for polygon.
OpenAPI Specification
openapi: 3.0.2
info:
title: Analytics Ethereum Polygon 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: Polygon
paths:
/analytics/pol/getCollectionPriceDiff:
post:
security:
- api_key: []
summary: Price Differentiation by Trait
description: Returns how trait differentiates price for a given collection
operationId: getPolCollectionPriceDiff
tags:
- Polygon
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The Polygon contract address to identify the collection.
example: '0xad59ecb77033391e847cc96829b08beb83151088'
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:
Trait Count: 9
Genesis Wings: 3
Genesis Head: 0
Genesis Eyes: 3
Genesis Body: 3
Genesis Beak: 3
Genesis Background: 4
Genesis Accessory: 0
Birthday: 3
Type: 52
Mutation: 12
Legendary Unique: 69
Legendary Wings: 69
Legendary Head: 72
Legendary Eyes: 72
Legendary Body: 69
Legendary Beak: 69
Legendary Background: 100
Legendary Accessory: 74
Collaboration Unique: 3
Collaboration Wings: 3
Collaboration Head: 3
Collaboration Eyes: 3
Collaboration Body: 3
Collaboration Beak: 3
Collaboration Background: 3
Collaboration Accessory: 3
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/pol/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: getPolCollectionSalesOHLC
tags:
- Polygon
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The Polygon contract address to identify the collection.
example: '0xfbe3ab0cbfbd17d06bdd73aa3f55aaf038720f59'
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
- matic
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:
- '0xfbe3ab0cbfbd17d06bdd73aa3f55aaf038720f59'
ohlc:
- block_timestamp: '2022-11-01 00:00:00'
close: 0.275
high: 0.275
low: 0.275
open: 0.275
- block_timestamp: '2022-11-02 00:00:00'
close: null
high: null
low: null
open: null
- block_timestamp: '2022-11-03 00:00:00'
close: 105
high: 105
low: 84
open: 90
- block_timestamp: '2022-07-19 00:00:00'
body_type: Male
close: 0.225
high: 0.225
low: 0.17
open: 0.17
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/pol/getCollectionSummary:
post:
security:
- api_key: []
summary: Summary Statistics by Collection
description: Returns summary analytics for a given collection
operationId: getPolCollectionSummary
tags:
- Polygon
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The contract address of the collection.
example: '0xfbe3ab0cbfbd17d06bdd73aa3f55aaf038720f59'
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 start timestamp in ISO 8601 format to pull data for calculations
example: '2023-01-01T00:00:00.000Z'
rept_curr:
type: string
enum:
- eth
- usd
- matic
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: 444.69807219681024
avg_daily_transaction_count: 2.6333333333333333
avg_daily_volume: 1651.9336139934883
gain_since_last_trough: 206.55589585198518
latest_floor_price: 337.1106736600027
latest_peak_date: '2022-11-17'
latest_rolling_5th_percentile: 363.1698305780777
latest_rolling_median: 350.1402521190402
latest_trough_date: '2022-11-14'
loss_since_last_peak: -74.95768330414523
max_daily_floor_price: 1346.1640859921092
min_daily_floor_price: 109.96711471593106
total_transaction_count: 158
total_transaction_volume: 99116.01683960929
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/pol/getLeaderBoard:
post:
security:
- api_key: []
summary: Polygon Leaderboard by Collection
description: Returns top collections by volume transaction volume or sales count
operationId: getPolLeaderBoard
tags:
- Polygon
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: seven_days
ranking_metric: eth_volume
leaderboard:
- rank: 1
collection_address: '0x5c76677fea2bf5dd37e4f1460968a23a537e3ee3'
collection_name: Mocaverse Realm Ticket
value: 249.26
type: ERC-1155
symbol: TICKET
- rank: 2
collection_address: '0x2f6fae917b6b28fb1b266bfa9236e945cd35a92f'
collection_name: Rubik's Check
value: 249.12
type: ERC-721
symbol: RC
- rank: 3
collection_address: '0x24a11e702cd90f034ea44faf1e180c0c654ac5d9'
collection_name: Trump Digital Trading Cards
value: 184.25
type: ERC-721
symbol: TRUMP
- rank: 4
collection_address: '0xa232f1b4b2a5b95e80d6c40eabc26f5d3409471a'
collection_name: Sewer Flask
value: 143.95
type: ERC-721
symbol: SF
- rank: 5
collection_address: '0x929844bcd8768b01b9db1666dbcecc3428688849'
collection_name: Extra Check
value: 70.68
type: ERC-721
symbol: EC
- rank: 6
collection_address: '0x8897e3a54a198fede22e0773ab7bae79665695e9'
collection_name: Win Trump Prizes
value: 70.33
type: ERC-721
symbol: TPRIZES
- rank: 7
collection_address: '0x9d305a42a3975ee4c1c57555bed5919889dce63f'
collection_name: Sandbox's LANDs
value: 54.65
type: ERC-721
symbol: LAND
- rank: 8
collection_address: '0xa604060890923ff400e8c6f5290461a83aedacec'
collection_name: null
value: 37.23
type: null
symbol: null
- rank: 9
collection_address: '0xd86eb478e84afdfdd13ac3483cce1066ac702153'
collection_name: SWAGGA Extra
value: 35.7
type: ERC-721
symbol: SE
- rank: 10
collection_address: '0xba6666b118f8303f990f3519df07e160227cce87'
collection_name: Planet IX - Assets
value: 35.18
type: ERC-1155
symbol: PIX-A
- rank: 11
collection_address: '0xdb46d1dc155634fbc732f92e853b10b288ad5a1d'
collection_name: Lens Protocol Profiles
value: 32.86
type: ERC-721
symbol: null
- rank: 12
collection_address: '0xa5f1ea7df861952863df2e8d1312f7305dabf215'
collection_name: ZED Horse
value: 32.37
type: ERC-721
symbol: ZED
- rank: 13
collection_address: '0x419e82d502f598ca63d821d3bbd8dfefaf9bbc8d'
collection_name: Polygon Ape Yacht Club
value: 30.65
type: ERC-721
symbol: PAYC
- rank: 14
collection_address: '0x64752705afccd2f9bf2e1c227b029bf458a71b25'
collection_name: fdgdfg
value: 30.5
type: ERC-721
symbol: dfgdfg
- rank: 15
collection_address: '0x22d5f9b75c524fec1d6619787e582644cd4d7422'
collection_name: Sunflower Land Collectibles
value: 23.29
type: ERC-1155
symbol: null
- rank: 16
collection_address: '0x2953399124f0cbb46d2cbacd8a89cf0599974963'
collection_name: OpenSea Collections
value: 20.36
type: ERC-1155
symbol: OPENSTORE
- rank: 17
collection_address: '0xf7fc3049d7fe36b474b471d8ccb59e95e0d7d270'
collection_name: JapanDream Reward
value: 20.17
type: ERC-721
symbol: JR
- rank: 18
collection_address: '0x647a263ecb8aab53ee2a1fb4a96af426c5e9d9ba'
collection_name: Shatterpoint
value: 11.34
type: ERC-721
symbol: shatterpoint
- rank: 19
collection_address: '0xfbe3ab0cbfbd17d06bdd73aa3f55aaf038720f59'
collection_name: Voxies
value: 10.1
type: ERC-721
symbol: VOXIES
- rank: 20
collection_address: '0x9d3aca725a289c6e798355592cd3dd5e43fa14a5'
collection_name: DerbyStarsHorse
value: 7.9
type: ERC-721
symbol: DSHORSE
- rank: 21
collection_address: '0xc7a096b4c6610ba3a836070333ff7922b9866a36'
collection_name: GensoKishiOnline
value: 7.58
type: ERC-721
symbol: Genso_NFT
- rank: 22
collection_address: '0x4bb5b2461e9ef782152c3a96698b2a4cf55b6162'
collection_name: null
value: 6.87
type: ERC-1155
symbol: null
- rank: 23
collection_address: '0x99a558bdbde247c2b2716f0d4cfb0e246dfb697d'
collection_name: 'Crypto Unicorns: Items Marketplace'
value: 6.78
type: ERC-1155
symbol: null
- rank: 24
collection_address: '0x053ba6f215ff0c8b031ef8cb0d4cf08e539ee53f'
collection_name: NewVerseContract
value: 6.7
type: ERC-721
symbol: NewVerseNFT
- rank: 25
collection_address: '0x355dca0e68175e42fdcbdd492250d1e928345123'
collection_name: Blokpax Razz
value: 6.58
type: ERC-1155
symbol: RAZZ
- rank: 26
collection_address: '0xb6041eae62c4591458af480679c6a497eda6cfcd'
collection_name: Cross the Ages - Arkhante Booster Premium Pack
value: 6.17
type: ERC-1155
symbol: CTAPRM
- rank: 27
collection_address: '0x47749c5b970e63f3a0ed57cd6cef773e74fafe9d'
collection_name: Cute, Cool and Creepy x Reddit Collectible Avatars
value: 5.75
type: ERC-1155
symbol: null
- rank: 28
collection_address: '0xd4d6cb5341fcab06dcefd7e6355b1cd8743ac0fc'
collection_name: Kuroro Beasts - Origins
value: 5.66
type: ERC-721
symbol: KBOG
- rank: 29
collection_address: '0xbac7e3182bb6691f180ef91f7ae4530abb3dc08d'
collection_name: SmurfTickets
value: 5.32
type: ERC-721
symbol: TSST
- rank: 30
collection_address: '0x95fcb7f46f1e652fdf23db087c0f24011775be00'
collection_name: Phantom Galaxies Origin Collection
value: 5.23
type: ERC-1155
symbol: PGOGC
- rank: 31
collection_address: '0xc52d9642260830055c986a97794b7b27393edf5e'
collection_name: VeryLongAnimals
value: 5
type: ERC-721
symbol: VeryLongAnimals
- rank: 32
collection_address: '0xa9a6a3626993d487d2dbda3173cf58ca1a9d9e9f'
collection_name: Unstoppable Domains
value: 4.9
type: ERC-721
symbol: UD
- rank: 33
collection_address: '0x687e4d88c45eba1aefb0ace6d127d038e7235943'
collection_name: Pirate
value: 4.52
type: ERC-721
symbol: PIRATE
- rank: 34
collection_address: '0x5fdf45a0ff4883b9f681b1800d6670d1d155811d'
collection_name: Hunters On-Chain
value: 4.33
type: ERC-721
symbol: hunters_on_chain
- rank: 35
collection_address: '0x67f4732266c7300cca593c814d46bee72e40659f'
collection_name: ZED Horse
value: 4.16
type: ERC-721
symbol: ZED
- rank: 36
collection_address: '0xe8ca04b6a982097bce37f1e6c1d74dc00191df87'
collection_name: OYABUN Yakuza
value: 4.09
type: ERC-721
symbol: OYABUN_YAKUZA
- rank: 37
collection_address: '0x9d77cb4d8371736e2a2b2bfaa677b7841cdc8fc1'
collection_name: DeRace Horses
value: 3.86
type: ERC-721
symbol: DRCHRS
- rank: 38
collection_address: '0x42b4a7db1ed930198bc37971b33e86f19ce88600'
collection_name: EGGRYPTO:Monster
value: 3.82
type: ERC-721
symbol: EGGRM
- rank: 39
collection_address: '0x5e40037d3c0b2afa1495582431f27a83d199a6d8'
collection_name: Infinite Moments
value: 3.63
type: ERC-1155
symbol: MOMENTS
- rank: 40
collection_address: '0x98e62fe371519d1d07e6f5bfce04737d4dacabfd'
collection_name: null
value: 3.52
type: ERC-1155
symbol: null
- rank: 41
collection_address: '0x3e4627665bf2e52c69be03788e664ab545f2be71'
collection_name: 'Spooky Season: Rojom x Reddit Collectible Avatars'
value: 3.24
type: ERC-1155
symbol: null
- rank: 42
collection_address: '0xa3396af20ce52bd3c7ab6d7046be617257f60eb9'
collection_name: Memetic Traders x Reddit Collectible Avatars
value: 3.2
type: ERC-1155
symbol: null
- rank: 43
collection_address: '0xdc0479cc5bba033b3e7de9f178607150b3abce1f'
collection_name: Crypto Unicorns
value: 3.09
type: ERC-721
symbol: UNICORNS
- rank: 44
collection_address: '0xefd33f6b372d08826c444ba79761782278901e10'
collection_name: OrbCity District
value: 2.98
type: ERC-721
symbol: OCDT
- rank: 45
collection_address: '0x907808732079863886443057c65827a0f1c64357'
collection_name: Foustlings x Reddit Collectible Avatars
value: 2.93
type: ERC-1155
symbol: null
- rank: 46
collection_address: '0xc7b68797297ececb7e733e5baeff284250db98c9'
collection_name: GingerMooar
value: 2.93
type: ERC-721
symbol: GINGER
- rank: 47
collection_address: '0x57a9b65ceac6c5ee0cec8cd4571a7c3805b558d8'
collection_name: null
value: 2.85
type: ERC-1155
symbol: null
- rank: 48
collection_address: '0xdd649d6daceff4e504231718868d577a67feb18a'
collection_name: ICE Plague
value: 2.83
type: ERC-721
symbol: DCL-ICEPLG
- rank: 49
collection_address: '0x8f8e18dbebb8ca4fc2bc7e3425fcdfd5264e33e8'
collection_name: Voxie Tactics Items
value: 2.77
type: ERC-721
symbol: VXTITEMS
- rank: 50
collection_address: '0x77cd42b925e1a82f41d852d6be727cfc88fddbbc'
collection_name: 'GFARM2 NFT 2 '
value: 2.7
type: ERC-721
symbol: GFARM2NFT2
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/pol/getRarity:
post:
security:
- api_key: []
summary: Token Rarity by Collection
description: Returns rarity by token for a given collection
operationId: getPolRarity
tags:
- Polygon
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The Polygon contract address to identify the collection.
example: '0xfbe3ab0cbfbd17d06bdd73aa3f55aaf038720f59'
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/pol/getTokenSummary:
post:
security:
- api_key: []
summary: Summary Statistics by Token
description: Returns summary analytics for a given token
operationId: getPolTokenSummary
tags:
- Polygon
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The contract address of the token collection.
example: '0xfbe3ab0cbfbd17d06bdd73aa3f55aaf038720f59'
token_id:
type: array
description: The id for the token.
items:
type: string
example: '1608'
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
- matic
description: The currency to report results in
example: eth
exclude_wash:
type: boolean
description: Exclude suspected wash transactions?
example: 'true'
required:
- collection_address
- token_id
responses:
'200':
description: An object containing the token's analytical summary.
content:
application/json:
example:
status: 200
response:
- collection_percentile: '1'
currency_symbol: MATIC
latest_collection_floor_price: 337.1106736600027
latest_gross_median_spread_price: 0
latest_sale: '2022-11-21'
max_date: '2022-11-21 14:16:07'
max_price: 363.1698305780777
min_date: '2022-11-21 14:16:07'
min_price: 363.1698305780777
price: 363.1698305780777
rolling_coll_median_price: 363.1698
rolling_coll_median_returns: 21.4997
rolling_collection_percentile_price: 363.1698
rolling_collection_percentile_returns: 21.4997
times_traded: 1
token_id: '1608'
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/pol/getWashTrade:
post:
security:
- api_key: []
summary: Wash Trades by Transaction
description: Returns suspected wash trades for a given transaction hash
operationId: getPolWashTrade
tags:
- Polygon
requestBody:
content:
application/json:
schema:
type: object
properties:
transaction_hash:
type: string
description: The transaction hash to valildate.
example: '0x40692e18987ef5237cb0f9f0eaf8898e044a140b94d1cfc2a66dc9eb39033c1a'
required:
- transaction_hash
responses:
'200':
description: OK
content:
application/json:
example:
status: 200
response:
- collection_address: '0x9d305a42a3975ee4c1c57555bed5919889dce63f'
collection_name: Sandbox's LANDs
token_id: '162611'
from_address: '0x0c66c1dcb2bdba5a37b455cf1901ed5e290674c0'
to_address: '0x8b69ce750eecc8c0d45ee7a1175ed5057d439462'
eth_value: 1.2
matic_value: 1681.2831
usd_value: 1345.93
exchange: Opensea - Seaport
block_number: 35881816
block_timestamp: '2022-11-21T11:02:16.000Z'
txn_hash: '0x40692e18987ef5237cb0f9f0eaf8898e044a140b94d1cfc2a66dc9eb39033c1a'
token_amount: 1
susp_wash: null
'400':
description: Bad request
'403':
description: Unauthorized
/analytics/pol/getWashTransactions:
post:
security:
- api_key: []
summary: Wash Trades by Collection
description: Returns suspected wash trades by token for a given collection
operationId: getPolWashTransactions
tags:
- Polygon
requestBody:
content:
application/json:
schema:
type: object
properties:
collection_address:
type: string
description: The collection address to search.
example: '0xfbe3ab0cbfbd17d06bdd73aa3f55aaf038720f59'
token_id:
type: array
description: An optional list of token ids.
items:
type: string
example: '2334'
# --- truncated at 32 KB (100 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gallop/refs/heads/main/openapi/gallop-polygon-api-openapi.yml