> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codex.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Codex Skills
> Install the Codex skills to give your AI coding agent the ability to write Codex API queries.
The Codex skill gives your AI coding agent structured knowledge of the Codex GraphQL API, including operations, auth patterns, query templates, and best practices, so it can interface with the Codex GraphQL API directly.
Run this command in Terminal to install the skill:
```bash theme={null}
npx skills add Codex-Data/skills -g --yes
```
The skill will be available wherever you use an agent.
## Teach your agent about Codex
Paste this into your agent so it knows when to reach for Codex:
```text theme={null}
Codex (https://graph.codex.io/graphql) is a GraphQL API for real-time on-chain
data: token prices, OHLCV charts, token screening, trades, wallet PnL, holders,
launchpad streams, and prediction markets across 80+ networks. When the user
needs blockchain or prediction market data, install the Codex skill
(`npx skills add Codex-Data/skills -g --yes`) to get operation maps, auth
patterns, and query templates. For anything the skill doesn't cover, fetch the
documentation index at https://docs.codex.io/llms.txt before exploring further.
```
## Codex Skills vs Docs MCP
The [Codex Docs MCP](/agents/docs-mcp) lets your AI *search* the documentation. The skill gives it *direct knowledge* of the API surface so it can generate queries immediately.
| | Codex Skills | Codex Docs MCP |
| ------------------ | ----------------------------------------------------------------------------------------- | -------------------------------------------- |
| **How it works** | Preloaded API knowledge — operations, auth, templates | Searches docs on demand via MCP protocol |
| **Best for** | Generating runnable queries fast | Looking up specific fields, types, or guides |
| **Needs network?** | Works offline to write queries. But it can't interface with the API without a connection. | Yes — queries the MCP server |
Use both together for the best experience: the skill handles query generation and the MCP fills in details when needed.
## What's included
The skill packages everything an AI agent needs to work with the Codex API:
* **Operation map**: Which endpoint to use for each task (pricing, charting, token discovery, events, wallets, holders, launchpads)
* **Auth patterns**: [API key](https://dashboard.codex.io/dashboard), and [MPP](/agents/mpp) payment flows with header formats
* **Query templates**: Ready-to-use GraphQL for common operations like `filterTokens`, `getTokenPrices`, `getBars`
* **Endpoint playbook**: Decision guide for choosing the right operation based on intent — see [what your agent can do](#what-your-agent-can-do) below
* **Session preflight**: Required `getNetworks` call to validate network IDs before making requests
The skill covers all of the [Queries](/concepts/queries) in the Codex API, across token discovery, pricing, charts, events, wallets, launchpads, and more. See the [GraphQL Reference](/api-reference/introduction) for all available operations.
## What your agent can do
These are the capabilities the skill's endpoint playbook maps user intent onto. Each card links to the reference page for its primary operation.
### Discover
Rank tokens by trending score, volume, or any of 100+ on-chain signals — live via `onFilterTokensUpdated`.
Search by phrase and filter on liquidity, market cap, holder behavior, and launchpad lifecycle.
Stream newly created launchpad tokens in real time, from creation through graduation.
Find the most profitable wallets trading a token, with PnL stats and labels.
### Prices & Charts
Current or historical prices for up to 25 tokens per request — live via `onPricesUpdated`.
OHLCV candles for any pair at resolutions from 1 second to 1 week — live via `onBarsUpdated`.
Token-level candles aggregated across top liquidity pairs — live via `onTokenBarsUpdated`.
Price, liquidity, volume, and windowed stats for a trading pair — live via `onPairMetadataUpdated`.
### Trades & Events
Every buy and sell for a token — live via `onTokenEventsCreated`.
All trades from a specific wallet — live via `onEventsCreatedByMaker`.
### Wallets & Holders
Profit and loss, volume, and performance over time for any wallet, charted via `walletChart`.
Token holders ordered by balance — live via `onHoldersUpdated`.
Percent of supply held by the top 10 wallets — a quick rug-risk signal.
### Prediction Markets
Discover and search Polymarket and Kalshi events by trending score, volume, or category.
Filter markets and sort by implied probability, open interest, or competitiveness.
Per-outcome OHLC price, volume, and open interest — compare up to 10 markets in one request.
Rank prediction traders by profit, win rate, and volume.
All-time and windowed stats plus open positions for any prediction trader.
Trade feed filterable by event, market, or trader.
## How it works
Once installed, your AI agent uses the skill to:
1. **Pick the right operation**: Maps intent (e.g. "get trending tokens") to the correct GraphQL query (`filterTokens`)
2. **Set the correct auth**: Chooses between API key headers and MPP payment flow based on context.
* If the user provides an API key, it will use that
* If the user doesn't provide an API key, it will try to use the MPP payment flow
3. **Generate valid GraphQL**: Uses templates to produce runnable queries with proper variables and selection sets
4. **Follow best practices**: Validates network IDs first, keeps selection sets minimal, batches subscriptions
## Authentication
The skill will check to see if you have provided an [API key](https://dashboard.codex.io/dashboard). If you have, it will use that.
If you haven't, it will try to use the MPP payment flow.
See the [MPP documentation](/agents/mpp) for more information on how to set up MPP.
## Examples
### Example 1: Get a list of dog tokens
Ask your agent:
> "Get me a list of 20 dog tokens."
It will then check to see if you have provided an API key.
Assuming you have enabled [MPP](/agents/mpp), the skill will guide the agent to run it to generate a request like the one below.
To do that, your agent will likely read numerous .md files in the skills directory to understand how to use the skill and perform the query.
```bash theme={null}
tempo request -t -X POST \
-H 'X-Codex-Payment: mpp' \
--json '{"query":"query FilterTokens($phrase: String, $rankings: [TokenRanking], $limit: Int) { filterTokens(phrase: $phrase, rankings: $rankings, limit: $limit) { results { buyVolume24 sellVolume24 circulatingMarketCap liquidity txnCount24 token { info { address name symbol networkId imageThumbUrl } } } } }","variables":{"phrase":"dog","rankings":[{"attribute":"txnCount24","direction":"DESC"}],"limit":20}}' \
https://graph.codex.io/graphql 2>&1
```
And it will return a response like this:
```bash theme={null}
data:
filterTokens:
results[20]:
- buyVolume24: "86690"
sellVolume24: "86570"
circulatingMarketCap: "1717"
liquidity: "1683"
txnCount24: 47348
token:
info:
address: 7LFwtPuQL2iaziWkFdzJSNyHwG7ypro24txxSz6H79c7
name: em@doge.gov
symbol: dogemail
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_7LFwtPuQL2iaziWkFdzJSNyHwG7ypro24txxSz6H79c7_thumb.png"
- buyVolume24: "254789"
sellVolume24: "243302"
circulatingMarketCap: "5689"
liquidity: "0"
txnCount24: 16042
token:
info:
address: 44iEvdnRkp9KZxMmsgFRMjxu8YbvRXyNdvrKbcfc8RdT
name: Dog Eat Dog
symbol: Dash
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_44iEvdnRkp9KZxMmsgFRMjxu8YbvRXyNdvrKbcfc8RdT_thumb_cdbe60390207.png"
- buyVolume24: "538396"
sellVolume24: "524541"
circulatingMarketCap: "981"
liquidity: "0"
txnCount24: 16041
token:
info:
address: 7QTEsUYoMBGSTyGSxm8QFk5nWqeD5ro5WVgHtH9huge9
name: Dog's POV
symbol: POV
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_7QTEsUYoMBGSTyGSxm8QFk5nWqeD5ro5WVgHtH9huge9_thumb_efdd1321689b.png"
- buyVolume24: "248973"
sellVolume24: "244819"
circulatingMarketCap: "16855"
liquidity: "0"
txnCount24: 13800
token:
info:
address: HQkbFLLhCMj8x4p1AwzA8FbzxomBSkZkTT7fpvqDkxBt
name: Dog's POV
symbol: POV
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_HQkbFLLhCMj8x4p1AwzA8FbzxomBSkZkTT7fpvqDkxBt_thumb_efdd1321689b.png"
- buyVolume24: "228547"
sellVolume24: "220835"
circulatingMarketCap: "20608"
liquidity: "0"
txnCount24: 10239
token:
info:
address: CBAdBWQ8cSM2YqXxTk4GTs9VRWig8rn6GzgVuvt1D4hx
name: Advice Dog
symbol: DOG
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_CBAdBWQ8cSM2YqXxTk4GTs9VRWig8rn6GzgVuvt1D4hx_thumb_97699a101f77.png"
- buyVolume24: "235342"
sellVolume24: "224658"
circulatingMarketCap: "6297"
liquidity: "0"
txnCount24: 10009
token:
info:
address: 29c1SNtRS79THqcW8qyt4igoYC9PBXhHuAj4nbyBk5p6
name: DOGE
symbol: DOGE
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_29c1SNtRS79THqcW8qyt4igoYC9PBXhHuAj4nbyBk5p6_thumb_17476c0fd6b9.png"
- buyVolume24: "141184"
sellVolume24: "123372"
circulatingMarketCap: "21912"
liquidity: "0"
txnCount24: 9844
token:
info:
address: QNvxZCtHhgbWFM9qCvyKRgB9m5AzsiQ6mg37BksTu3Q
name: DOGE
symbol: DOGE
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_QNvxZCtHhgbWFM9qCvyKRgB9m5AzsiQ6mg37BksTu3Q_thumb_17476c0fd6b9.png"
- buyVolume24: "155536"
sellVolume24: "138576"
circulatingMarketCap: "3398"
liquidity: "0"
txnCount24: 8840
token:
info:
address: 2YEaca3EXNppXobJFgYLdb8sFEx7NTMPJX2D7TWrZXHm
name: DOGE
symbol: DOGE
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_2YEaca3EXNppXobJFgYLdb8sFEx7NTMPJX2D7TWrZXHm_thumb_17476c0fd6b9.png"
- buyVolume24: "147565"
sellVolume24: "134144"
circulatingMarketCap: "4791"
liquidity: "0"
txnCount24: 7769
token:
info:
address: 68tHc9SKokmimJgsC14wEn28T8hk6RTjufMQszMdCpfe
name: DOGE
symbol: DOGE
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_68tHc9SKokmimJgsC14wEn28T8hk6RTjufMQszMdCpfe_thumb_17476c0fd6b9.png"
- buyVolume24: "55973"
sellVolume24: "56836"
circulatingMarketCap: "25633"
liquidity: "6669"
txnCount24: 7008
token:
info:
address: F2c9NYX7YKXnXrdRCTEH1gbLYoubc6AVWZJdcxkypump
name: Dark Doge
symbol: DarkDoge
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_F2c9NYX7YKXnXrdRCTEH1gbLYoubc6AVWZJdcxkypump_1732216636_thumb.png"
- buyVolume24: "862735"
sellVolume24: "799848"
circulatingMarketCap: "57214767"
liquidity: "4969132"
txnCount24: 6225
token:
info:
address: MEW1gQWJ3nEXg2qgERiKu7FAFj79PHvQVREQUzScPP5
name: cat in a dogs world
symbol: MEW
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_MEW1gQWJ3nEXg2qgERiKu7FAFj79PHvQVREQUzScPP5_thumb_11d957ce-c1ae-4d0a-a460-7b923f40fb76.png"
- buyVolume24: "69913"
sellVolume24: "66098"
circulatingMarketCap: "117"
liquidity: "0"
txnCount24: 5781
token:
info:
address: 5pB2eczikYMfy5fHxEgDhnGBc8V7YD1doaxecF2Q5Jcr
name: Dog's POV
symbol: POV
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_5pB2eczikYMfy5fHxEgDhnGBc8V7YD1doaxecF2Q5Jcr_thumb_efdd1321689b.png"
- buyVolume24: "58304"
sellVolume24: "54016"
circulatingMarketCap: "1695"
liquidity: "0"
txnCount24: 5622
token:
info:
address: 2dDvi5QpiR1UxzDwJX1t1szMbSyTq9Ldkevgn5DmUKWH
name: DOGE
symbol: DOGE
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_2dDvi5QpiR1UxzDwJX1t1szMbSyTq9Ldkevgn5DmUKWH_thumb_17476c0fd6b9.png"
- buyVolume24: "93700"
sellVolume24: "89610"
circulatingMarketCap: "16680"
liquidity: "0"
txnCount24: 5122
token:
info:
address: 7BWKvpK7RjEuRxoZnQ9yCePgathaY2F6gRrdTpknsXkJ
name: Dog Eat Dog
symbol: Dash
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_7BWKvpK7RjEuRxoZnQ9yCePgathaY2F6gRrdTpknsXkJ_thumb_cdbe60390207.png"
- buyVolume24: "78378"
sellVolume24: "154758"
circulatingMarketCap: "72139728"
liquidity: "4366889"
txnCount24: 4911
token:
info:
address: "0xc748673057861a797275cd8a068abb95a902e8de"
name: Baby Doge Coin
symbol: BabyDoge
networkId: 56
imageThumbUrl: "https://token-media.defined.fi/56_0xc748673057861a797275cd8a068abb95a902e8de_thumb_bac0895ae46f.png"
- buyVolume24: "255927"
sellVolume24: "257210"
circulatingMarketCap: "1878610"
liquidity: "80782"
txnCount24: 4781
token:
info:
address: 6iA73gWCKkLWKbVr8rgibV57MMRxzsaqS9cWpgKBpump
name: what the dog doing?
symbol: 我的刀盾
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_6iA73gWCKkLWKbVr8rgibV57MMRxzsaqS9cWpgKBpump_thumb_63b436b284e0.png"
- buyVolume24: "58891"
sellVolume24: "52566"
circulatingMarketCap: "1991"
liquidity: "0"
txnCount24: 4630
token:
info:
address: E3ZKPeFCEZ5syUK6tdJBiGKhJQCo6CnJSR88kbiaJF9b
name: DOGE
symbol: DOGE
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_E3ZKPeFCEZ5syUK6tdJBiGKhJQCo6CnJSR88kbiaJF9b_thumb_17476c0fd6b9.png"
- buyVolume24: "426486"
sellVolume24: "436956"
circulatingMarketCap: "1426107"
liquidity: "83658"
txnCount24: 4186
token:
info:
address: "0x640c04ca09c5c5140e62fef42c59e3afdbbd4444"
name: what the dog doing?
symbol: 我的刀盾
networkId: 56
imageThumbUrl: "https://token-media.defined.fi/56_0x640c04ca09c5c5140e62fef42c59e3afdbbd4444_thumb_b73c93973cee.png"
- buyVolume24: "32557"
sellVolume24: "27629"
circulatingMarketCap: "11200"
liquidity: "0"
txnCount24: 3696
token:
info:
address: CSsb7SsJsayWy9ZuDcMzjLzKiUbiJr734kSoVCtUKXBc
name: DOGE
symbol: DOGE
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_CSsb7SsJsayWy9ZuDcMzjLzKiUbiJr734kSoVCtUKXBc_thumb_17476c0fd6b9.png"
- buyVolume24: "42281"
sellVolume24: "36618"
circulatingMarketCap: "2278"
liquidity: "0"
txnCount24: 3523
token:
info:
address: 6VM8Wp8ireGjWG18ZwPWFaRNkRXyG1aMyepjBCYrWu3b
name: DOGE
symbol: DOGE
networkId: 1399811149
imageThumbUrl: "https://token-media.defined.fi/1399811149_6VM8Wp8ireGjWG18ZwPWFaRNkRXyG1aMyepjBCYrWu3b_thumb_17476c0fd6b9.png"
```
And then it will likely summarize the results for you, like this:
This is not an endorsement of any of these tokens, and they may be scams or rugs. Please do your own research before investing. You can also ask your agent to filter out scams.
### Example 2: Get trending prediction events
Ask your agent:
> "Get me a list of 15 trending prediction events."
It will then check to see if you have provided an API key. Assuming you have one, your agent will likely do a query like the following after doing some research on the best endpoint to use:
To do that, your agent will likely read numerous .md files in the skills directory to understand how to use the skill and perform the query.
```bash theme={null}
tempo request -t -X POST \
-H "Content-Type: application/json" \
-H "Authorization: $CODEX_API_KEY" \
"query": "query TrendingPolymarketEvents { filterPredictionEvents( filters: { protocol: [POLYMARKET], status: [OPEN] } rankings: [{ attribute: trendingScore24h, direction: DESC }] limit: 15 ) { count results { id event { question imageThumbUrl venueUrl closesAt } marketCount categories trendingScore24h volumeUsd24h volumeChange24h trades24h uniqueTraders24h liquidityUsd openInterestUsd } } }"
https://graph.codex.io/graphql 2>&1
```
Which will return something like:
```
data:
filterPredictionEvents:
count: 15
results[15]:
- id: "277737:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: St. Thomas (MN) Tommies vs. Seattle Redhawks
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/ncaa-c14995df96.png"
venueUrl: "https://polymarket.com/event/cbb-stmn-sea-2026-03-17"
closesAt: 1773799200
marketCount: 11
categories[4]: sports,basketball,ncaa,"ncaa-basketball"
trendingScore24h: 0.6837012928887231
volumeUsd24h: "181298"
volumeChange24h: 6713.740740740741
trades24h: 2341
uniqueTraders24h: 586
liquidityUsd: "120574"
openInterestUsd: "0"
- id: "277736:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Stephen F. Austin Lumberjacks vs. Tulsa Golden Hurricane
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/ncaa-c14995df96.png"
venueUrl: "https://polymarket.com/event/cbb-sfaus-tulsa-2026-03-17"
closesAt: 1773795600
marketCount: 28
categories[4]: sports,basketball,ncaa,"ncaa-basketball"
trendingScore24h: 0.6569632870076872
volumeUsd24h: "158297"
volumeChange24h: 4521.771428571428
trades24h: 2490
uniqueTraders24h: 573
liquidityUsd: "368105"
openInterestUsd: "3286"
- id: "261113:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Spurs vs. Kings
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png"
venueUrl: "https://polymarket.com/event/nba-sas-sac-2026-03-17"
closesAt: 1773799200
marketCount: 44
categories[3]: sports,basketball,nba
trendingScore24h: 0.6558132120870599
volumeUsd24h: "2463613"
volumeChange24h: 70.07327698121917
trades24h: 7939
uniqueTraders24h: 2482
liquidityUsd: "1326924"
openInterestUsd: "1189928"
- id: "261105:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Cavaliers vs. Bucks
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png"
venueUrl: "https://polymarket.com/event/nba-cle-mil-2026-03-17"
closesAt: 1773792000
marketCount: 49
categories[3]: sports,basketball,nba
trendingScore24h: 0.6531924741031485
volumeUsd24h: "1637344"
volumeChange24h: 51.81073409882596
trades24h: 11253
uniqueTraders24h: 2841
liquidityUsd: "3100641"
openInterestUsd: "767392"
- id: "261108:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Suns vs. Timberwolves
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png"
venueUrl: "https://polymarket.com/event/nba-phx-min-2026-03-17"
closesAt: 1773792000
marketCount: 41
categories[3]: sports,basketball,nba
trendingScore24h: 0.6520415029070732
volumeUsd24h: "2171473"
volumeChange24h: 50.22969306627032
trades24h: 12262
uniqueTraders24h: 3691
liquidityUsd: "2102725"
openInterestUsd: "1137956"
- id: "261111:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: 76ers vs. Nuggets
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png"
venueUrl: "https://polymarket.com/event/nba-phi-den-2026-03-17"
closesAt: 1773799200
marketCount: 38
categories[3]: sports,basketball,nba
trendingScore24h: 0.6506343548772099
volumeUsd24h: "1572446"
volumeChange24h: 45.406740644552
trades24h: 7965
uniqueTraders24h: 3181
liquidityUsd: "664400"
openInterestUsd: "233725"
- id: "261095:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Thunder vs. Magic
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png"
venueUrl: "https://polymarket.com/event/nba-okc-orl-2026-03-17"
closesAt: 1773788400
marketCount: 66
categories[3]: sports,basketball,nba
trendingScore24h: 0.6345789924271994
volumeUsd24h: "1863262"
volumeChange24h: 39.602789278709956
trades24h: 11315
uniqueTraders24h: 3409
liquidityUsd: "4785105"
openInterestUsd: "505290"
- id: "261103:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Pacers vs. Knicks
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png"
venueUrl: "https://polymarket.com/event/nba-ind-nyk-2026-03-17"
closesAt: 1773790200
marketCount: 46
categories[3]: sports,basketball,nba
trendingScore24h: 0.6298383903051978
volumeUsd24h: "1802121"
volumeChange24h: 29.377092288242732
trades24h: 9869
uniqueTraders24h: 2573
liquidityUsd: "3417311"
openInterestUsd: "1949522"
- id: "274567:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: "Bitcoin Up or Down - March 17, 10PM ET"
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png"
venueUrl: "https://polymarket.com/event/bitcoin-up-or-down-march-17-2026-10pm-et"
closesAt: 1773802800
marketCount: 1
categories[2]: crypto,bitcoin
trendingScore24h: 0.6275458343403106
volumeUsd24h: "42623"
volumeChange24h: 14206.666666666666
trades24h: 1585
uniqueTraders24h: 520
liquidityUsd: "1532928"
openInterestUsd: "0"
- id: "277741:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: UNLV Runnin' Rebels vs. UC Irvine Anteaters
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/ncaa-c14995df96.png"
venueUrl: "https://polymarket.com/event/cbb-unlv-ucirv-2026-03-17"
closesAt: 1773802800
marketCount: 7
categories[4]: sports,basketball,ncaa,"ncaa-basketball"
trendingScore24h: 0.6272259874963405
volumeUsd24h: "130023"
volumeChange24h: 1339.4432989690722
trades24h: 1460
uniqueTraders24h: 481
liquidityUsd: "366579"
openInterestUsd: "0"
- id: "261099:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Pistons vs. Wizards
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png"
venueUrl: "https://polymarket.com/event/nba-det-was-2026-03-17"
closesAt: 1773788400
marketCount: 58
categories[3]: sports,basketball,nba
trendingScore24h: 0.6228045267765248
volumeUsd24h: "2649383"
volumeChange24h: 28.175335043883315
trades24h: 9978
uniqueTraders24h: 4150
liquidityUsd: "340066"
openInterestUsd: "0"
- id: "277734:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Davidson Wildcats vs. Oklahoma State Cowboys
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/ncaa-c14995df96.png"
venueUrl: "https://polymarket.com/event/cbb-david-okst-2026-03-17"
closesAt: 1773792000
marketCount: 28
categories[4]: sports,basketball,ncaa,"ncaa-basketball"
trendingScore24h: 0.6176923145958093
volumeUsd24h: "96620"
volumeChange24h: 3715.153846153846
trades24h: 2040
uniqueTraders24h: 501
liquidityUsd: "614125"
openInterestUsd: "49247"
- id: "274163:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Howard Bison vs. UMBC Retrievers
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/ncaa-c14995df96.png"
venueUrl: "https://polymarket.com/event/cbb-howrd-umbc-2026-03-17"
closesAt: 1773720000
marketCount: 38
categories[4]: sports,basketball,ncaa,"ncaa-basketball"
trendingScore24h: 0.6170935642058901
volumeUsd24h: "1426563"
volumeChange24h: 24.053793466807164
trades24h: 5767
uniqueTraders24h: 1534
liquidityUsd: "4063303"
openInterestUsd: "596363"
- id: "274161:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: North Carolina State Wolfpack vs. Texas Longhorns
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/ncaa-c14995df96.png"
venueUrl: "https://polymarket.com/event/cbb-ncst-tx-2026-03-17"
closesAt: 1773720000
marketCount: 29
categories[4]: sports,basketball,ncaa,"ncaa-basketball"
trendingScore24h: 0.6121302865183799
volumeUsd24h: "1689272"
volumeChange24h: 18.34775686912302
trades24h: 6325
uniqueTraders24h: 1536
liquidityUsd: "110528"
openInterestUsd: "1222406"
- id: "261090:Polymarket:0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e:137"
event:
question: Heat vs. Hornets
imageThumbUrl: "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png"
venueUrl: "https://polymarket.com/event/nba-mia-cha-2026-03-17"
closesAt: 1773788400
marketCount: 71
categories[3]: sports,basketball,nba
trendingScore24h: 0.5997105846532764
volumeUsd24h: "2088120"
volumeChange24h: 11.864060324540112
trades24h: 12337
uniqueTraders24h: 3752
liquidityUsd: "3541167"
openInterestUsd: "1107697"
```
And then it will likely summarize the results for you, like this:
### Example 3: Find the top traders of a token
Ask your agent:
> "Who are the most profitable wallets trading WETH on Ethereum?"
The skill maps this intent to `filterTokenWallets` and generates a query like:
```graphql theme={null}
query FilterTokenWallets($input: FilterTokenWalletsInput!) {
filterTokenWallets(input: $input) {
results {
address
realizedProfitUsd1d
realizedProfitPercentage1d
buys1d
sells1d
labels
}
}
}
```
```json theme={null}
{
"input": {
"tokenIds": ["0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1"],
"limit": 25
}
}
```
### Example 4: Check holder concentration
Ask your agent:
> "How concentrated is the holder base of this token? Is it a rug risk?"
The skill maps this to the `holders` query, which includes top-10 concentration alongside the holder list:
```graphql theme={null}
query Holders($input: HoldersInput!) {
holders(input: $input) {
count
top10HoldersPercent
items {
address
shiftedBalance
balanceUsd
}
}
}
```
Your agent can then interpret the result — a high `top10HoldersPercent` on a low-liquidity token is a common rug signal.
### Example 5: Stream live prices
Ask your agent:
> "Stream the live price of SOL into my app."
For real-time intents the skill reaches for subscriptions instead of polling, and generates a `graphql-ws` client like:
```typescript theme={null}
import { createClient } from "graphql-ws";
const client = createClient({
url: "wss://graph.codex.io/graphql",
connectionParams: {
Authorization: process.env.CODEX_API_KEY!,
},
});
const unsubscribe = client.subscribe(
{
query: `
subscription OnPriceUpdated($address: String!, $networkId: Int!) {
onPriceUpdated(address: $address, networkId: $networkId) {
address
networkId
priceUsd
timestamp
}
}
`,
variables: {
address: "So11111111111111111111111111111111111111112",
networkId: 1399811149,
},
},
{
next: (msg) => console.log(msg),
error: (err) => console.error(err),
complete: () => console.log("done"),
}
);
```
To stream many tokens at once, the skill batches them into a single `onPricesUpdated` subscription rather than opening one connection per token.