For the complete documentation index, see llms.txt. This page is also available as Markdown.

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: 20
cursorstring · 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 · enumOptional

Filter native activity before pagination: swaps >= 0.01 native units, LP >= 0.05; unknown/non-native pool values and synthesized fees excluded.

Possible values:
Responses
200

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: 20
cursorstring · 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 · enumOptional

Filter native activity before pagination: swaps >= 0.01 native units, LP >= 0.05; unknown/non-native pool values and synthesized fees excluded.

Possible values:
Responses
200

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: 20
cursorstring · 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
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: 20
cursorstring · 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
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?