Skip to main content
Submit reported metrics

Authorizations

Authorization
string
header
default:Token <token>
required

Token-based authentication with required prefix "Token ". Example: "Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b"

Body

application/json
organization
string
required

Organization slug. Available organizations are returned in the /v1/organizations endpoint

asset
string
required

Asset symbol. Available assets are returned in the /v1/organizations endpoint. You cannot submit data for unsupported assets

exchange
string
required

Exchange slug. Supported exchanges are returned in the /v1/organizations endpoint, but you can also submit data for unsupported exchanges

pair
string
required

Pair. Supported pairs are returned in the /v1/organizations endpoint, but you can also submit data for unsupported pairs

ts_iso
string<date-time>
required

UTC timestamp in ISO format. For daily data (default), 2025-08-27T00:00:00Z encompasses data from 12:00 am to 11:59 pm on 27/08/2025. For hourly data, 2025-08-27T13:00:00Z encompasses data from 1:00 pm to 1:59 pm on 27/08/2025. For 5-minute data, 2025-08-27T13:05:00Z encompasses data from 1:05 pm to 1:09 pm on 27/08/2025.

metric
string
required

Valid metrics:

  • volume/volume: Volume traded for day, normalised to USD values
  • spread/spread_bps: Top Of Book Spread basis points, calculated as (your ask - your bid) / ((your ask + your bid) / 2)) * 10000
  • depth/bid_0bps: Bid Depth, normalised to USD values, within 0 basis points
  • depth/bid_0.05bps: Bid Depth, normalised to USD values, within 0.05 basis points
  • depth/bid_0.1bps: Bid Depth, normalised to USD values, within 0.1 basis points
  • depth/bid_0.15bps: Bid Depth, normalised to USD values, within 0.15 basis points
  • depth/bid_0.25bps: Bid Depth, normalised to USD values, within 0.25 basis points
  • depth/bid_0.5bps: Bid Depth, normalised to USD values, within 0.5 basis points
  • depth/bid_0.75bps: Bid Depth, normalised to USD values, within 0.75 basis points
  • depth/bid_1bps: Bid Depth, normalised to USD values, within 1 basis points
  • depth/bid_2bps: Bid Depth, normalised to USD values, within 2 basis points
  • depth/bid_3bps: Bid Depth, normalised to USD values, within 3 basis points
  • depth/bid_5bps: Bid Depth, normalised to USD values, within 5 basis points
  • depth/bid_10bps: Bid Depth, normalised to USD values, within 10 basis points
  • depth/bid_15bps: Bid Depth, normalised to USD values, within 15 basis points
  • depth/bid_20bps: Bid Depth, normalised to USD values, within 20 basis points
  • depth/bid_25bps: Bid Depth, normalised to USD values, within 25 basis points
  • depth/bid_30bps: Bid Depth, normalised to USD values, within 30 basis points
  • depth/bid_40bps: Bid Depth, normalised to USD values, within 40 basis points
  • depth/bid_50bps: Bid Depth, normalised to USD values, within 50 basis points
  • depth/bid_60bps: Bid Depth, normalised to USD values, within 60 basis points
  • depth/bid_75bps: Bid Depth, normalised to USD values, within 75 basis points
  • depth/bid_100bps: Bid Depth, normalised to USD values, within 100 basis points
  • depth/bid_150bps: Bid Depth, normalised to USD values, within 150 basis points
  • depth/bid_200bps: Bid Depth, normalised to USD values, within 200 basis points
  • depth/bid_300bps: Bid Depth, normalised to USD values, within 300 basis points
  • depth/bid_500bps: Bid Depth, normalised to USD values, within 500 basis points
  • depth/ask_0bps: Ask Depth, normalised to USD values, within 0 basis points
  • depth/ask_0.05bps: Ask Depth, normalised to USD values, within 0.05 basis points
  • depth/ask_0.1bps: Ask Depth, normalised to USD values, within 0.1 basis points
  • depth/ask_0.15bps: Ask Depth, normalised to USD values, within 0.15 basis points
  • depth/ask_0.25bps: Ask Depth, normalised to USD values, within 0.25 basis points
  • depth/ask_0.5bps: Ask Depth, normalised to USD values, within 0.5 basis points
  • depth/ask_0.75bps: Ask Depth, normalised to USD values, within 0.75 basis points
  • depth/ask_1bps: Ask Depth, normalised to USD values, within 1 basis points
  • depth/ask_2bps: Ask Depth, normalised to USD values, within 2 basis points
  • depth/ask_3bps: Ask Depth, normalised to USD values, within 3 basis points
  • depth/ask_5bps: Ask Depth, normalised to USD values, within 5 basis points
  • depth/ask_10bps: Ask Depth, normalised to USD values, within 10 basis points
  • depth/ask_15bps: Ask Depth, normalised to USD values, within 15 basis points
  • depth/ask_20bps: Ask Depth, normalised to USD values, within 20 basis points
  • depth/ask_25bps: Ask Depth, normalised to USD values, within 25 basis points
  • depth/ask_30bps: Ask Depth, normalised to USD values, within 30 basis points
  • depth/ask_40bps: Ask Depth, normalised to USD values, within 40 basis points
  • depth/ask_50bps: Ask Depth, normalised to USD values, within 50 basis points
  • depth/ask_60bps: Ask Depth, normalised to USD values, within 60 basis points
  • depth/ask_75bps: Ask Depth, normalised to USD values, within 75 basis points
  • depth/ask_100bps: Ask Depth, normalised to USD values, within 100 basis points
  • depth/ask_150bps: Ask Depth, normalised to USD values, within 150 basis points
  • depth/ask_200bps: Ask Depth, normalised to USD values, within 200 basis points
  • depth/ask_300bps: Ask Depth, normalised to USD values, within 300 basis points
  • depth/ask_500bps: Ask Depth, normalised to USD values, within 500 basis points
value
number<double>
required
interval
enum<string>
default:1d

Interval of the reported metric. Defaults to 1d.

  • 1d - Daily data.
  • 1h - Hourly data.
  • 5m - 5-minute data.
Available options:
1d,
1h,
5m
dry_run
boolean

Resolve and report this item exactly like a real submission, without writing it. Counted under dry_run_results.

Response

message
string
required
results
object
required

Items submitted without dry_run.

dry_run_results
object
required

Items submitted with dry_run; none of them were written.

unlisted_pairs
object[]
required
rejected
object[]
required