{"uid":"cap_s3c73qhE7fJKbsJmGnu2L","slug":"onesource-deepstate-maker-analytics-bea0c434","name":"OneSource Deepstate Maker Analytics","description":"Deepstate, the on-chain order-book exchange on Robinhood Chain. Per-maker time-at-top, notional rested, fills, and DEEP rewards earned for a market.","url":"https://api.onesource.io/deepstate/v1/analytics/makers","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["book"],"properties":{"to":{"type":"string"},"book":{"type":"string"},"from":{"type":"string"},"limit":{"type":"integer","maximum":500,"minimum":1}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"maker":{"type":"string"},"fill_rate":{"type":"number"},"fill_count":{"type":"integer"},"order_count":{"type":"integer"},"deep_earned_raw":{"type":"string"},"notional_rested_raw":{"type":"string"},"denominated_order_count":{"type":"integer"},"time_at_top_ask_seconds":{"type":"integer"},"time_at_top_bid_seconds":{"type":"integer"}}}},"book_id":{"type":"string"},"finality":{"type":"string"},"book_slug":{"type":"string"},"book_label":{"type":"string"},"size_token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"}}},"as_of_block":{"type":"integer"},"rewards_available":{"type":"boolean"}},"description":"Endpoint-specific response payload"}}}}},"responseSchema":{"type":"json","example":{"to":"2026-09-02T16:00:00Z","from":"2026-09-01T16:00:00Z","rows":[{"maker":"0x6cf19308C22FC82ea620Fa0B3E94948d20f27B96","fill_rate":0.86,"fill_count":194,"order_count":12,"deep_earned_raw":"1811294000000000000000","notional_rested_raw":"82441000000","denominated_order_count":12,"time_at_top_ask_seconds":6120,"time_at_top_bid_seconds":41820}],"book_id":"0xdf941c235503a5d2e67aee5dea00f2965f99421c0d034bd77f924c05c66bf399","finality":"safe","book_slug":"NVDA-USDG","book_label":"NVDA/USDG","size_token":{"symbol":"USDG","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","decimals":6},"as_of_block":52685009,"rewards_available":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rXHWI2PyQtBb_fkryPN8V","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-maker time-at-top-of-book, notional rested, fill counts, fill rate, and DEEP rewards earned for a specified Deepstate market book.","exampleAgentPrompt":"Pull the maker analytics for the ETH/USDC Deepstate book — I want to see who's been at the top of the bid and ask the longest, their fill rates, and how much DEEP each maker has earned. Limit it to the top 50 makers.","exampleUseCases":[{"title":"Leaderboard of top DEEP reward earners","prompt":"Give me a ranked list of market makers on the BTC/USDC Deepstate book sorted by DEEP rewards earned — show their fill rates and how long each one sat at the top of the order book."},{"title":"Maker performance audit for a trading firm","prompt":"Pull the maker stats for our wallet address on the SOL/USDC Deepstate book over the last 24 hours — I need fill count, fill rate, notional rested, and total DEEP earned."},{"title":"Monitor market depth quality over time","prompt":"Get the time-at-top-of-bid and time-at-top-of-ask stats for all makers on the DEEP/USDC book from block range covering the past week, up to 100 makers, so I can assess who's providing the most consistent liquidity."}],"resultDescription":"Returns a JSON object containing the book ID, slug, label, finality status, current block number, rewards availability flag, size token metadata, and an array of per-maker rows. Each row includes maker address, fill rate (decimal), fill count, order count, denominated order count, raw DEEP rewards earned (string bigint), raw notional rested (string bigint), time at top of ask in seconds, and time at top of bid in seconds. The response is scoped to the requested time window (from/to) and limited by the requested row count.","failureModes":["Missing required 'book' query parameter returns a 400 error","Invalid or unknown book ID returns empty rows or 404","'limit' outside 1-500 range returns a validation error","Time range parameters malformed or in wrong format returns 400","Endpoint returns stale data if the chain head is lagging","Payment of 0.02 USDC not provided via x402 returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need granular, per-maker analytics for a Deepstate on-chain order book — specifically time-at-top-of-book, fill statistics, and DEEP token rewards. It is the right choice when analyzing market maker performance, computing reward distributions, or auditing liquidity provision quality on Deepstate markets. Prefer this over generic DEX analytics when you need maker-level decomposition rather than aggregate market statistics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:19.094Z","isFirstParty":false}