Integration Docs

Introduction

Welcome to the Copin Integration Guide! This guide helps developers, partners, and traders seamlessly connect with Copin’s features, such as trader profiles, position data, and leaderboards, to enhance their platforms.

Integrating with Copin unlocks trading insights, transaction data, and performance metrics, offering valuable information to your users and building transparency and trust. Leaderboard integration further boosts engagement by showcasing top traders and encouraging competition.

With clear steps, examples, and URLs, this guide ensures a smooth integration process, enabling you to fully utilize Copin’s data-rich ecosystem.

Protocol List

Copin partners with a variety of perpetual exchanges, offering users access to detailed trading data and insights. Each integration provides unique benefits, allowing easy access to information from preferred protocols. Here is the current list of supported perpdex protocols:

PROTOCOL	SHORT KEY	NAME	CHAIN	ACTIVE	ALLOW COPY
GMX	GMA	GMX	Arbitrum	Yes	Yes
GMX_V2	GMA2	GMX V2	Arbitrum	Yes	Yes
KWENTA	KWO	Kwenta	Optimism	Yes	Yes
POLYNOMIAL	POO	Polynomial	Optimism	Yes	Yes
DEXTORO	DEO	Dextoro	Optimism	Yes	Yes
CYBERDEX	CYO	CyberDEX	Optimism	Yes	Yes
SYNTHETIX_V3	SYB3	Synthetix V3	Base	Yes	No
GNS	GNA	gTrade	Arbitrum	Yes	Yes
GNS_POLY	GNP	gTrade	Polygon	Yes	Yes
LEVEL_BNB	LEB	Level	BNB Chain	Yes	Yes
LEVEL_ARB	LEA	Level	Arbitrum	Yes	Yes
MUX_ARB	MUA	MUX	Arbitrum	Yes	Yes
EQUATION_ARB	EQA	Equation	Arbitrum	Yes	Yes
APOLLOX_BNB	APB	ApolloX	BNB Chain	Yes	Yes
AVANTIS_BASE	AVB	Avantis	Base	Yes	Yes
LOGX_BLAST	LOB	LogX	Blast	Yes	No
LOGX_MODE	LOM	LogX	Mode	Yes	No
MYX_ARB	MYA	MYX	Arbitrum	Yes	No
HMX_ARB	HMA	HMX	Arbitrum	Yes	Yes
VELA_ARB	VEA	Vela	Arbitrum	Yes	Yes
KTX_MANTLE	KTM	KTX	Mantle	Yes	No
YFX_ARB	YFA	YFX	Arbitrum	Yes	No
KILOEX_OPBNB	KIO	KiloEx	opBNB	Yes	Yes
ROLLIE_SCROLL	ROS	Rollie	Scroll	Yes	Yes
PERENNIAL_ARB	PEA	Perennial	Arbitrum	Yes	No
MUMMY_FANTOM	MUF	Mummy	Fantom	Yes	Yes
MORPHEX_FANTOM	MOF	Morphex	Fantom	Yes	Yes
HYPERLIQUID	HLP	Hyperliquid	Hyperliquid L1	Yes	No
SYNFUTURE_BASE	SYB	Synfutures	Base	Yes	No
DYDX	DYD	dYdX	dydX Chain	Yes	No
BSX_BASE	BSB	BSX	Base	Yes	No
UNIDEX_ARB	UNA	UniDex	Arbitrum	Yes	No
VERTEX_ARB	VEA	Vertex	Arbitrum	Yes	No

How to integrate Copin?

Integrators can access key features such as the Trader Profile, Position Details, and Leaderboard via the following URLs.

1. Trader Profile

The trader profile endpoint allows integrators to access detailed information about individual traders. To retrieve this data, use the following URL format:

https://app.copin.io/trader/[trader_address]/[protocol]?utm_source=[protocol]

Parameters:

• trader_address: Address of the trader. Example: 0xCf9D6C81167b183A384964d0A2ed2234feF81BDC

• protocol: Selected protocol from the protocol list. Example: KILOEX_OPBNB

Example URL:

https://app.copin.io/trader/0xCf9D6C81167b183A384964d0A2ed2234feF81BDC/kiloex_opbnb?time=FULL&utm_source=GNS

2. Position Details

To view specific position details, you can use the following endpoint:

https://app.copin.io/[protocol]/position/[order_tx_hash]?account=[trader_address]&tx_hash=[order_tx_hash]&log_id=[event_log_id]&side=[side]&utm_source=[protocol]

Parameters:

• protocol: Selected protocol from the protocol list. Example: GMX_V2

• trader_address: Address of the trader. Example: 0x08c788aFdACF6cf81180D2bBBE42A7434D0C7A92

• order_tx_hash: Transaction hash of the order. Example: 0xd8779a7c74a71f6c9f049fe83957fb90d76cf0fef687cb25773cb4d713ad6eae

• event_log_id: Log ID of the event. Example: 43

• side: [long | short] Example: long

Example URL:

  - https://app.copin.io/GMX_V2/position/0xd8779a7c74a71f6c9f049fe83957fb90d76cf0fef687cb25773cb4d713ad6eae?account=0x08c788aFdACF6cf81180D2bBBE42A7434D0C7A92&log_id=43&side=long&utm_source=GMX_V2=

Note: The following protocols do not support this feature:

• Hyperliquid

3. Leaderboard

The leaderboard endpoint provides access to weekly or monthly trader rankings. Use the following URL format to retrieve leaderboard data:

https://app.copin.io/[protocol]/leaderboard?leaderboard_type=[type]&utm_source=[protocol]

• protocol: Selected protocol from the protocol list. Example: GNS

• leaderboard_type: Type of leaderboard. Can be WEEK or MONTH (default: MONTH).

Example URLs:

https://app.copin.io/GNS/leaderboard?utm_source=GNS

https://app.copin.io/GNS/leaderboard?leaderboard_type=WEEK&utm_source=GNS

Media Kit

For branding and promotional purposes, please refer to the official media files, which should not be altered. You can access them here: Media Kit

Contact Information

For further inquiries or technical support, please contact us via Telegram: Telegram: LeeCopin