Writing and Running Custom Event Handler Functions

Write a Custom Event Handler Function

You can process events related to any data updates by writing a custom event handler function for use with Datafeed Toolbox™. For example, you can monitor prices before creating an order or plot interval data in a graph. Follow these basic steps to write a custom event handler.

  1. Choose the events you want to process, monitor, or evaluate.

  2. Decide how the custom event handler processes these events.

  3. Determine the input and output arguments for the custom event handler function.

  4. Write the code for the custom event handler function.

For details, see Create Functions in Files (MATLAB). For a code example of a Bloomberg® event handler function, enter edit v3stockticker.m at the command line.

Run a Custom Event Handler Function

You can run the custom event handler function by passing the function name as an input argument into an existing function. For the Enterprise Platform from Refinitiv™ function fetch, specify the custom event handler as a character vector or string. For other functions, specify the custom event handler function name either as a character vector, string, or function handle. For details about function handles, see Create Function Handle (MATLAB).

For example, suppose you want to retrieve real-time data from Bloomberg using realtime with the custom event handler function named eventhandler. You can use either of these syntaxes to run eventhandler. This code assumes a Bloomberg connection c, security list s, Bloomberg data fields f, Bloomberg subscription subs, and MATLAB® timer t.

Use a character vector or string.

[subs,t] = realtime(c,s,f,'eventhandler');

Or, use a function handle.

[subs,t] = realtime(c,s,f,@eventhandler);

Workflow for Custom Event Handler Function

This workflow summarizes the basic steps to work with a custom event handler function for any of the data service providers.

  1. Write a custom event handler function and save it to a file.

  2. Create a connection to the data service provider.

  3. Subscribe to a specific security using an existing function or API syntax.

  4. Run an existing function to receive data updates and use the custom event handler function as an input argument.

  5. Stop data updates by using stop or closing the connection to the data service provider.

  6. Close the connection to the data service provider if the connection is still open.

See Also

|

Related Topics