How to send data to GumboNet

Data is the driving force behind Smart Contracts. Learn how to provide the data required to execute your smart contracts.


  • Basic knowledge of how APIs work

  • Basic programming experience


  • API Key

  • Basic understanding of DG data models

  • Basic understanding of GraphQL

Sending data to Data Gumbo is done via our APIs. If for some reason accessing our APIs is not possible, reach out to the Customer Success team for other options.

Data Gumbo categorizes data into one of two buckets: “structured” and “unstructured”. There is no initial obvious demarcation between the two kinds of data except for which API is used. This article will focus on “structured” data.


“Unstructured” data is usually high-frequency data such as sensor readings. Due to the large and varying nature of these kinds of data sets, the “unstructured” API has been specifically designed to handle working with big data sets with many timestamps and differing formats. Sometimes this data can be referred to as “Time Series” data.


Everything that doesn’t fall into the “unstructured” bucket is considered “structured”. Another way to easily identify “structured” data is to cross-reference the model being used with the models detailed on the Voyager page. The bulk of data interactions happens with “structured” data.


Structrured Data API URL

GraphQL Voyager - Commodity

GraphQL Voyager - Drilling


The following instructions detail how to construct an HTTP request. Where and how the request is executed is completely up to the user and will not be covered in this article.

The API Playground can be used to interact with “structured” data. Postman is a tool that can be used to interact with both “structured” and “unstructured” data.


  1. Get the Base URL using the link above

  2. Add Request Headers

    apiKey - this is a Data Gumbo provided key

  3. Construct the JSON request payload

    The request payload will differ for every kind of model but will follow this basic structure:

    API - Structured
  4. Send Request via HTTP POST
  5. Verify returned data
    A malformed payload will result in an error but the request will still return a 200 Status Code
  6. The response must be checked for any errors
  • Response WITH Error
API - check response with error


  • Response WITHOUT Error

API - Respones without error

There are multiple ways to construct a GraphQL Query. Here is an example.

API - Example