Activity
Activity feeds — global, per collection, per token, and per user.
Chronological feeds of protocol activity. Read the whole chain's activity, or scope it to a single collection, a single token, or a single user's address.
get
Path parameters
chainstring · min: 1Required
Query parameters
limitinteger · min: 1 · max: 100OptionalDefault:
20cursorstring · min: 1Optional
typesstringOptionalPattern:
^(?:NEW|CREATED|RELISTED|FILLED|TRANSFERRED|CANCELLED|EXTENDED|REPRICED|DEPOSITED|REDEEMED|SWAPPED|POOL_BUY|POOL_SELL|LP_ADDED|LP_REMOVED|LAUNCH_CREATED|LAUNCH_FINALIZED|LAUNCH_CANCELLED|LAUNCH_CLAIM|POOL_FEE_DONATION|AMM_FEE_TAKEN)(?:,(?:NEW|CREATED|RELISTED|FILLED|TRANSFERRED|CANCELLED|EXTENDED|REPRICED|DEPOSITED|REDEEMED|SWAPPED|POOL_BUY|POOL_SELL|LP_ADDED|LP_REMOVED|LAUNCH_CREATED|LAUNCH_FINALIZED|LAUNCH_CANCELLED|LAUNCH_CLAIM|POOL_FEE_DONATION|AMM_FEE_TAKEN))*$visibilitystring · enumOptionalPossible values:
Filter native activity before pagination: swaps >= 0.01 native units, LP >= 0.05; unknown/non-native pool values and synthesized fees excluded.
Responses
200
Default Response
application/json
400
Default Response
application/json
500
Default Response
application/json
get/v1/{chain}/activity
GET /v1/{chain}/activity HTTP/1.1
Host: api.nftx.io
Accept: */*
{
"data": [
{
"id": "text",
"chainId": 1,
"collection": "text",
"collectionName": "text",
"collectionSymbol": "text",
"collectionSlug": "text",
"tokenMedia": {
"imageUrl": "text",
"thumbnailUrl": "text",
"backgroundColor": "text"
},
"counterpartyTokenMedia": {
"imageUrl": "text",
"thumbnailUrl": "text",
"backgroundColor": "text"
},
"tokenId": "text",
"type": "text",
"actor": "text",
"from": "text",
"to": "text",
"amount": "text",
"amount0": "text",
"amount1": "text",
"floorMultiple": 1,
"ethPrice": "text",
"seedTokenIds": [
"text"
],
"launchId": "text",
"launchpad": "text",
"pairAmount": "text",
"pairToken": {
"address": "text",
"symbol": "text",
"decimals": 1,
"isEthEquivalent": true
},
"meta": "text",
"txHash": "text",
"timestamp": "text"
}
],
"pageInfo": {
"limit": 1,
"cursor": "text",
"nextCursor": "text",
"hasNextPage": true
}
}get
Path parameters
chainstring · min: 1Required
collectionstringRequiredPattern:
^(?:0x[a-fA-F0-9]{40}|[a-z0-9]+(?:-[a-z0-9]+)*)$Query parameters
limitinteger · min: 1 · max: 100OptionalDefault:
20cursorstring · min: 1Optional
typesstringOptionalPattern:
^(?:NEW|CREATED|RELISTED|FILLED|TRANSFERRED|CANCELLED|EXTENDED|REPRICED|DEPOSITED|REDEEMED|SWAPPED|POOL_BUY|POOL_SELL|LP_ADDED|LP_REMOVED|LAUNCH_CREATED|LAUNCH_FINALIZED|LAUNCH_CANCELLED|LAUNCH_CLAIM|POOL_FEE_DONATION|AMM_FEE_TAKEN)(?:,(?:NEW|CREATED|RELISTED|FILLED|TRANSFERRED|CANCELLED|EXTENDED|REPRICED|DEPOSITED|REDEEMED|SWAPPED|POOL_BUY|POOL_SELL|LP_ADDED|LP_REMOVED|LAUNCH_CREATED|LAUNCH_FINALIZED|LAUNCH_CANCELLED|LAUNCH_CLAIM|POOL_FEE_DONATION|AMM_FEE_TAKEN))*$visibilitystring · enumOptionalPossible values:
Filter native activity before pagination: swaps >= 0.01 native units, LP >= 0.05; unknown/non-native pool values and synthesized fees excluded.
Responses
200
Default Response
application/json
400
Default Response
application/json
500
Default Response
application/json
get/v1/{chain}/collections/{collection}/activity
GET /v1/{chain}/collections/{collection}/activity HTTP/1.1
Host: api.nftx.io
Accept: */*
{
"data": [
{
"id": "text",
"chainId": 1,
"collection": "text",
"collectionName": "text",
"collectionSymbol": "text",
"collectionSlug": "text",
"tokenMedia": {
"imageUrl": "text",
"thumbnailUrl": "text",
"backgroundColor": "text"
},
"counterpartyTokenMedia": {
"imageUrl": "text",
"thumbnailUrl": "text",
"backgroundColor": "text"
},
"tokenId": "text",
"type": "text",
"actor": "text",
"from": "text",
"to": "text",
"amount": "text",
"amount0": "text",
"amount1": "text",
"floorMultiple": 1,
"ethPrice": "text",
"seedTokenIds": [
"text"
],
"launchId": "text",
"launchpad": "text",
"pairAmount": "text",
"pairToken": {
"address": "text",
"symbol": "text",
"decimals": 1,
"isEthEquivalent": true
},
"meta": "text",
"txHash": "text",
"timestamp": "text"
}
],
"pageInfo": {
"limit": 1,
"cursor": "text",
"nextCursor": "text",
"hasNextPage": true
}
}get
Path parameters
chainstring · min: 1Required
collectionstringRequiredPattern:
^(?:0x[a-fA-F0-9]{40}|[a-z0-9]+(?:-[a-z0-9]+)*)$tokenIdstringRequiredPattern:
^(0|[1-9][0-9]*)$Query parameters
limitinteger · min: 1 · max: 100OptionalDefault:
20cursorstring · min: 1Optional
typesstringOptionalPattern:
^(?:NEW|CREATED|RELISTED|FILLED|TRANSFERRED|CANCELLED|EXTENDED|REPRICED|DEPOSITED|REDEEMED|SWAPPED|POOL_BUY|POOL_SELL|LP_ADDED|LP_REMOVED|LAUNCH_CREATED|LAUNCH_FINALIZED|LAUNCH_CANCELLED|LAUNCH_CLAIM|POOL_FEE_DONATION|AMM_FEE_TAKEN)(?:,(?:NEW|CREATED|RELISTED|FILLED|TRANSFERRED|CANCELLED|EXTENDED|REPRICED|DEPOSITED|REDEEMED|SWAPPED|POOL_BUY|POOL_SELL|LP_ADDED|LP_REMOVED|LAUNCH_CREATED|LAUNCH_FINALIZED|LAUNCH_CANCELLED|LAUNCH_CLAIM|POOL_FEE_DONATION|AMM_FEE_TAKEN))*$Responses
200
Default Response
application/json
400
Default Response
application/json
500
Default Response
application/json
get/v1/{chain}/collections/{collection}/tokens/{tokenId}/activity
GET /v1/{chain}/collections/{collection}/tokens/{tokenId}/activity HTTP/1.1
Host: api.nftx.io
Accept: */*
{
"data": [
{
"id": "text",
"chainId": 1,
"collection": "text",
"collectionName": "text",
"collectionSymbol": "text",
"collectionSlug": "text",
"tokenMedia": {
"imageUrl": "text",
"thumbnailUrl": "text",
"backgroundColor": "text"
},
"counterpartyTokenMedia": {
"imageUrl": "text",
"thumbnailUrl": "text",
"backgroundColor": "text"
},
"tokenId": "text",
"type": "text",
"actor": "text",
"from": "text",
"to": "text",
"amount": "text",
"amount0": "text",
"amount1": "text",
"floorMultiple": 1,
"ethPrice": "text",
"seedTokenIds": [
"text"
],
"launchId": "text",
"launchpad": "text",
"pairAmount": "text",
"pairToken": {
"address": "text",
"symbol": "text",
"decimals": 1,
"isEthEquivalent": true
},
"meta": "text",
"txHash": "text",
"timestamp": "text"
}
],
"pageInfo": {
"limit": 1,
"cursor": "text",
"nextCursor": "text",
"hasNextPage": true
}
}get
Path parameters
chainstring · min: 1Required
addressstringRequiredPattern:
^0x[a-fA-F0-9]{40}$Query parameters
limitinteger · min: 1 · max: 100OptionalDefault:
20cursorstring · min: 1Optional
typesstringOptionalPattern:
^(?:NEW|CREATED|RELISTED|FILLED|TRANSFERRED|CANCELLED|EXTENDED|REPRICED|DEPOSITED|REDEEMED|SWAPPED|POOL_BUY|POOL_SELL|LP_ADDED|LP_REMOVED|LAUNCH_CREATED|LAUNCH_FINALIZED|LAUNCH_CANCELLED|LAUNCH_CLAIM|POOL_FEE_DONATION|AMM_FEE_TAKEN)(?:,(?:NEW|CREATED|RELISTED|FILLED|TRANSFERRED|CANCELLED|EXTENDED|REPRICED|DEPOSITED|REDEEMED|SWAPPED|POOL_BUY|POOL_SELL|LP_ADDED|LP_REMOVED|LAUNCH_CREATED|LAUNCH_FINALIZED|LAUNCH_CANCELLED|LAUNCH_CLAIM|POOL_FEE_DONATION|AMM_FEE_TAKEN))*$Responses
200
Default Response
application/json
400
Default Response
application/json
500
Default Response
application/json
get/v1/{chain}/users/{address}/activity
GET /v1/{chain}/users/{address}/activity HTTP/1.1
Host: api.nftx.io
Accept: */*
{
"data": [
{
"id": "text",
"chainId": 1,
"collection": "text",
"collectionName": "text",
"collectionSymbol": "text",
"collectionSlug": "text",
"tokenMedia": {
"imageUrl": "text",
"thumbnailUrl": "text",
"backgroundColor": "text"
},
"counterpartyTokenMedia": {
"imageUrl": "text",
"thumbnailUrl": "text",
"backgroundColor": "text"
},
"tokenId": "text",
"type": "text",
"actor": "text",
"from": "text",
"to": "text",
"amount": "text",
"amount0": "text",
"amount1": "text",
"floorMultiple": 1,
"ethPrice": "text",
"seedTokenIds": [
"text"
],
"launchId": "text",
"launchpad": "text",
"pairAmount": "text",
"pairToken": {
"address": "text",
"symbol": "text",
"decimals": 1,
"isEthEquivalent": true
},
"meta": "text",
"txHash": "text",
"timestamp": "text"
}
],
"pageInfo": {
"limit": 1,
"cursor": "text",
"nextCursor": "text",
"hasNextPage": true
}
}Last updated
Was this helpful?