To connect to the WebSocket API, you will need to use the appropriate URL for your environment:
- Test:
wss://ws.test.figmarkets.com - Production:
wss://ws.figmarkets.com
See the Authentication Guide for more information on how to authenticate.
To subscribe to channels, send a JSON-RPC message in the following format:
{
"jsonrpc": "2.0",
"id": "<your-request-id>",
"method": "v1/subscribe",
"params": { "channels": ["channel1", "channel2"] }
}This will respond with:
{
"jsonrpc": "2.0",
"id": "<your-request-id>",
"method": "v1/subscribe",
"result": {
"status": "subscribed",
"channels": ["channel1", "channel2"]
}
}To unsubscribe from channels, send a JSON-RPC message in the following format:
{
"jsonrpc": "2.0",
"id": "<your-request-id>",
"method": "v1/unsubscribe",
"params": { "channels": ["channel1", "channel2"] }
}This will respond with:
{
"jsonrpc": "2.0",
"id": "<your-request-id>",
"method": "v1/unsubscribe",
"result": {
"status": "unsubscribed",
"channels": ["channel1", "channel2"]
}
}Below are the available WebSocket channels
- rfq.maker - This channel is used to receive updates for RFQs you are able to quote against.
- rfq.taker - This channel is used to receive updates for RFQs where you are the
taker. - rfq_quote.maker - This channel is used to receive notifications on quotes created by you as the
maker. - rfq_quote.taker - This channel is used to receive notifications on quotes received for RFQs where you are the
taker.