Skip to main content

Datafeed REST API

The Datafeed API is a specialized service designed to facilitate the retrieval of call data essential for updating collection results on a destination blockchain. It offers endpoints to access information about active collections and their related calldata, ensuring seamless integration and data synchronization across blockchain networks. The call data provided should be used to call the updateAndGetResult(bytes calldata _data) function described here.

Endpoints​

API for the supported Testnet networks is https://api-staging.razorscan.io

1. List of Active Collections​

  • Endpoint: /collections
  • Method: GET
  • Description: This endpoint provides a list of active collections, detailing both their unique identifiers (ids) and their corresponding cryptographic name hashes (nameHash). It is intended to give an overview of all collections that are curently active in the protocol. The lastUpdatedEpoch tells us the last epoch the collections were updated on. For the current epoch check Razorscan.
  • Curl Example:
    curl -X GET 'https://api-prod.razorscan.io/collections'
  • Example Response
    {"id":"activeCollections","ids":[2,3],"lastUpdatedEpoch":1419225,"nameHash":["0x59102b37de83bdda9f38ac8254e596f0d9ac61d2035c07936675e87342817160","0x7404e3d104ea7841c3d9e6fd20adfe99b4ad586bc08d8f3bd3afef894cf184de"]}

2. Fetch Calldata of Collection​

  • Endpoint: /collection/:nameHash

  • Method: GET

  • Description: This endpoint retrieves the calldata associated with a specific collection, identified by its nameHash. The nameHash is a unique cryptographic identifier for each collection, ensuring that the data retrieved is specific and relevant to the requested collection. This endpoint is crucial for applications that need to update or verify collection data on a blockchain.

  • Curl Example:

    curl -X GET 'https://api-prod.razorscan.io/collection/${nameHash}'

  • Example Response

    {"id":2,"calldata":"0x43222d5abbd0b3698c3debf3a90e96171043b84be44498978c2b7c0b0115851a00000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000259102b37de83bdda9f38ac8254e596f0d9ac61d2035c07936675e87342817160000000000000000000000000000000000000000000000000000000000003617f000000000000000000000000000000000000000000000000000000006582e96d00000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000001f093d1fb72f3c58e60387bb2b6a6fd3df502a15ccd340ac5ae2e900f7670ecc600000000000000000000000000000000000000000000000000000000000000415d58884709a53a71019f99523805182185d2a2edf3701c2d00772eb2f00fcad2466453c999879998995c7b0445e47fd6df0118654c2aead134eb1d914f1e364e1c00000000000000000000000000000000000000000000000000000000000000","nameHash":"0x59102b37de83bdda9f38ac8254e596f0d9ac61d2035c07936675e87342817160","timestamp":1703078253}