# Pair Data

Pair endpoints expose metadata for a pair and audit breakdowns (single or batch) including developer, top holders, insiders, bundlers, snipers, and LP burn distribution.

## Get Metadata for Pair

> Returns the underlying token metadata for a given pair address. Social fields are omitted.

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Pair Data","description":"Pair endpoints expose metadata for a pair and audit breakdowns (single or batch) including developer, top holders, insiders, bundlers, snipers, and LP burn distribution."}],"paths":{"/pairs/{pairAddress}/metadata":{"get":{"summary":"Get Metadata for Pair","description":"Returns the underlying token metadata for a given pair address. Social fields are omitted.","operationId":"get-pair-metadata","tags":["Pair Data"],"parameters":[{"name":"pairAddress","in":"path","required":true,"schema":{"type":"string"},"description":"The pair address (e.g., liquidity pool address)"}],"responses":{"200":{"description":"Pair metadata returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tokenName":{"type":"string","nullable":true},"tokenSymbol":{"type":"string","nullable":true},"tokenDescription":{"type":"string","nullable":true},"tokenImage":{"type":"string","nullable":true},"tokenSupply":{"type":"number"},"tokenDecimals":{"type":"integer","nullable":true},"devWallet":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":true},"graduatedAt":{"type":"string","format":"date-time","nullable":true},"basePool":{"type":"string","nullable":true},"quotePool":{"type":"string","nullable":true},"pairAddresses":{"type":"array","items":{"type":"string"}}},"required":["tokenSymbol"]},"meta":{"type":"object","properties":{"pairAddress":{"type":"string"},"tokenAddress":{"type":"string"}},"required":["pairAddress","tokenAddress"]}},"required":["data","meta"]}}}},"400":{"description":"Missing or invalid pair address","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"pairAddress":{"type":["string","null"]}},"required":["pairAddress"]}},"required":["error","meta"]}}}},"404":{"description":"Pair or token not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"pairAddress":{"type":"string"},"tokenAddress":{"type":["string","null"]}},"required":["pairAddress","tokenAddress"]}},"required":["error","meta"]}}}},"500":{"description":"Unexpected server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"pairAddress":{"type":["string","null"]},"tokenAddress":{"type":["string","null"]}},"required":["pairAddress","tokenAddress"]}},"required":["error","meta"]}}}}}}}}}
```

## Get Pair Audit

> Returns audit data for a single liquidity pair and its underlying token. Includes token-level distribution (developer, top holders, insiders, bundlers) and pair-level ownership breakdown (snipers, LP burn).

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Pair Data","description":"Pair endpoints expose metadata for a pair and audit breakdowns (single or batch) including developer, top holders, insiders, bundlers, snipers, and LP burn distribution."}],"paths":{"/pairs/{pairAddress}/audit":{"get":{"summary":"Get Pair Audit","description":"Returns audit data for a single liquidity pair and its underlying token. Includes token-level distribution (developer, top holders, insiders, bundlers) and pair-level ownership breakdown (snipers, LP burn).","operationId":"get-pair-audit","tags":["Pair Data"],"parameters":[{"name":"pairAddress","in":"path","required":true,"schema":{"type":"string"},"description":"The pair address (e.g., liquidity pool address)"}],"responses":{"200":{"description":"Pair audit data returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tokenSupply":{"type":"number","description":"Total token supply"},"developer":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"},"walletAddress":{"type":["string","null"],"description":"Developer wallet (from token.dev_wallet)"}}},"top10Holders":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"insiders":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"bundlers":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"snipers":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"lpBurn":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}}},"required":["tokenSupply","developer","top10Holders","insiders","bundlers","snipers","lpBurn"]},"meta":{"type":"object","properties":{"pairAddress":{"type":"string"},"tokenAddress":{"type":"string"}},"required":["pairAddress","tokenAddress"]}},"required":["data","meta"]}}}},"400":{"description":"Missing or invalid pairAddress","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"pairAddress":{"type":["string","null"]}},"required":["pairAddress"]}}}}}},"404":{"description":"Pair not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"pairAddress":{"type":"string"}},"required":["pairAddress"]}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"pairAddress":{"type":["string","null"]}},"required":["pairAddress"]}}}}}}}}}}}
```

## Get Pair Audit (Multiple)

> Returns audit data for multiple liquidity pairs in a single batch call. Accepts up to 10 pair addresses via the \`addresses\` query parameter. Each entry includes pair-level and token-level audit details including developer, top holders, insiders, bundlers, snipers, and LP burn distribution.\
> \
> \*\*Cost:\*\* 10 credits per request.

```json
{"openapi":"3.0.1","info":{"title":"Neglect API","version":"1.0.0"},"tags":[{"name":"Pair Data","description":"Pair endpoints expose metadata for a pair and audit breakdowns (single or batch) including developer, top holders, insiders, bundlers, snipers, and LP burn distribution."}],"paths":{"/pairs/audit":{"get":{"tags":["Pair Data"],"summary":"Get Pair Audit (Multiple)","description":"Returns audit data for multiple liquidity pairs in a single batch call. Accepts up to 10 pair addresses via the `addresses` query parameter. Each entry includes pair-level and token-level audit details including developer, top holders, insiders, bundlers, snipers, and LP burn distribution.\n\n**Cost:** 10 credits per request.","operationId":"get-pair-audit-multiple","parameters":[{"name":"addresses","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated list of up to 10 pair addresses"}],"responses":{"200":{"description":"Batch pair audit data returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"string"}},"pairs":{"type":"array","items":{"type":"object","properties":{"pairAddress":{"type":"string"},"tokenAddress":{"type":"string"},"tokenSupply":{"type":"number"},"developer":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"},"walletAddress":{"type":["string","null"],"description":"Developer wallet (from token.dev_wallet)"}}},"top10Holders":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"insiders":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"bundlers":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"snipers":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}},"lpBurn":{"type":"object","properties":{"tokenSupply":{"type":"number"},"percent":{"type":"number"}}}},"required":["pairAddress","tokenAddress"]}}},"required":["addresses","pairs"]},"meta":{"type":"object","properties":{"count":{"type":"integer"}},"required":["count"]}},"required":["data","meta"]}}}},"400":{"description":"Missing or invalid query parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string","nullable":true}},"required":["code","message"]},"meta":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"string"}},"invalid":{"type":"array","items":{"type":"string"},"nullable":true}},"required":["addresses"]}},"required":["error","meta"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"meta":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"string"}}},"required":["addresses"]}},"required":["error","meta"]}}}}}}}}}
```